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(54) Method and system for remote control and Interaction with a run time environment 
component 



(57) A user device, afirst computer system, includes 
a lightweight component that receives user Input actions 
for a runtime environment component that is executing 
on a second computer system. The lightweight compo- 
nent sends a remote input action command to a user 
interface infrastructure that is executing on the second 
computer system. In response to the remote input action 
command, the user interface Inf rastmcture sends a local 
input action command to the runtime environment com- 
ponent that processes the command, and issues a local 
output command to the user interface infrastructure that 
- in turn sends a remote outpu t command to th e light- 
weight component on the user device. In response to 
the remote output command, the lightweight component 
causes an output on the user device. 
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Description 

BACKGROUND OF THE INVENTION 
Field of the Invention 

rooon The oresent invention relates to runtime environment component services, and In particular to a runtime en- 
network. 

Description of Related Art 

100021 Todav manvcomputernetworksarearrangedasciient-serversystems. In a client-sen/er system, a potentially 
Z nuJ^SeTsmaiSTLter systems, like laptops or handhold organize-s. called clients, are. temporanly or 

soZare proarls aTe eSuted on the clTents. One prior art way to make a software program on the server available 
to S was ruse a browser on the client. The browser was used to transfer a relatively large software program or 
1 rela^ely ?arge part thereof from the server to a client so that the software program could be executed locally on the 
cliS This Sod required that the software program or a part thereof be stored and processed on the client 

Fo^Sis purfJse. the client must have sufficient storage capacity and processing capability to execute tt^e 
KireDroaramSly "Hiese requirements may conflict with the aim of having smaller and smaller clients, including 
S^te^pCel wifch may noJhave enough storage capacity or processing capability for stonng or processing, 

SoqL is e^cecuted The speed of this download depends on the available data transfer capacity of the ne^^^ork 
ZnTSr^o JTe server and the client. Here, frequently the available bandwidth of the network connection .s decisive. , 
rin^ inlnriSe d^^^^^^^^^ client-sen,er systems would be undesirably slow In executing a software program. 

Stforsomeres^^^ 

idSg a potentially large number of clients, If relevant software programs are amended or updated. Considerable 
administration efforts for client-server systems may be the consequence. „*.i^h avocutad on 

35 Sri It is also known to include into a software program executed on a client procedures, wh ch ^re^*''*?"^^ 
a sender A prior technique to implement this used CORBA. For example, certain more =°'^P''^*«^ ^a'*^'^*^"^ 
JeSS^oJwhteh mS be needed on a client, were carried out on a server connected with the client over a networi. 
Zlerwf required that Ihe program devetoper include particular commands into the code of the software program 
to be execTeZthe Intfor^ J the software program to be executed on the server, in the given example the 

. *rcuirn?og"rThiswasnotonly% 

rS^T^r^'kirtn^^^^^^^^^ execution of a program se.erfrom a client and to review *e 

S of tl^^ZnLirein on the client. This approach is used in the UNIX X-Windows svjem Howeve, m« 
l^rachSdLpem,itthedienttocontroltheprogram^^ 
45 the client side environment at the level of function calls. 

SUMMARY OF THE INVENTION . 

[0009] It is an object of the present invention to provide improved access from a first computer system to rasouroes 
so available at a second computer system. _. 'x , 

rOOIOl The object of the invention is achieved by the features of the independent claims. .^^...hoc « 

■ 0011 Ac^rd ng to one embodiment of the prasent invention, a user device, a first computer system, includes a 
rhtleiaht^mSnent that receives user input actions for a mntime environment component that is executing on a 
Sd cl^uTsysterke lightweight component sends a remote Input action command to a user interface inf ra- 

c^SnLirS mntil e^^^^^ P^"'^^^^^ ^ '"""^ * local output command 

. S^ruser^nSS'aSSe that in turn sends a remote output command to.the ligh^«eight component on.the 
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user device In response to the remote output command, the lightweight component causes an output on the user 
device This output could be redrawing a display, playing a sound, or perhaps routing information to a local pnnter 
foS' A 'the Lnagement of components in the user interface, management of data and so on .s performed on he 
Sd computer system and so the lightweight component only has. for example, to update the d;sp ay to reflect the 

5 Le of the Lme environment component as indicated by the remote output command ^^j" '» ^^^^^^^^^^^^ 
user that the mntime environment component is executing locally on the user device despite that fact that the user 
device is only functioning as an input/output device for the runtime environment component. 
r00141 In one embodiment, a method for presenting a runtime environment component service by a first computer 
Sstem to a second computer system over a communication network is perfomied by the first computer system The 

,0 Sod includes genemflng a user interface inf rastmcture on the first computer system. The user interface .nf ras^ruc- 
re receivesgraphicuserlnterfaceeventsfrom the second computersystem and sends remote graphic user interface 

commands to the second computer system. The user interface Infrastructure is used to imtia ize mnttme e^^^^^ 
ment component service. The runtime environment component service sends graphic user interface commands to the 

user interface infrastructure. i 

[00151 In another embodiment, the first computer system receives a remote input action command for a runtime 
environmentcomponent service viaacommunicationnetworicThe remote inputaction is being generated in the second 
computer system by a lightweight component corresponding to the runtime environment <=°'"P°"f ""^^^^^ 
input action command is transmitted to the mntime environment component service in response to the remote input 
action command. The local input action command is processed by the runtime environment component service, and 
a local output command is generated by the mntime environment component service for a graphical user interface. A 
remote output command is transmitted to the lightweight component in response to the local output command. 
1001 6] in yet another embodiment, a method for enabling a user device to mn a mntime environment component on 
another cornputer includes mnning a browser on the user device. A lightweight component is run within the browser. 
The lightweight component receives user input actions on the user device and generates corresponding user interface 
25 events to the another computer for processing by the mntime environment component. 

[00171 A computer program product, in one embodiment, comprises computer code including a remote frame window 
class mat in turn includes a remote output device interface and a remote frame window Interface. The computer code 
optionally includes any or all of a bean frame class comprising a frame interface; a bean window class including an 
event handler interface and a window peer interface; and an abstract windowing toolkit. 
30 [001 8] According to a further embodiment a method is provided for presenting mntime environment component serv- 
ices by a first computer system to a second computer system over a communication network, said method being 
performed by said first computer system, and comprising the steps of: 

a) receiving a request for a mntime environment component service via said communication networic said request 
being generated by a lightweight component in said second computer system, wherein the lightweight component 
corresponds to the requested mntime environment component service. 

b) accessing a runtime environment component being able to provide said-requested mntime environment com- 
- ponent. service. 

c) executing said mntime environment component on said firet computer system for producing a result according 
to said received request for a mntime environment component service. 

d) transmitting, over said network, a response comprising said result to said second computer system. 

r0019] The invention comprises also a method for providing mntime environment component services from a firet 
computer system over a communication network to a second computer system, said method being executed on said 
second computer system and comprising the steps of:- - - — — — _ _ 

a) generating a request for a mntime environment component service by means of a lightweight component of 
said second computer system, wherein the lightweight component corresponds to the requested mntime environ- 
ment component service, 

b) transmitting said request for said mntime environment component service to said first computer system over 
55 said communication network, and 

c) receiving a response comprising a result according to said requested mntime.environment component service 
said result being produced by a mntime environment component executed on said first computer system and 
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transmitted with said response by said first computer system over said network. 

[0020] Thus, the runtime environment component services are presented by a first computer system to a second 
computer system over a communication network, whereby upon receiving a request for a runtime environment com- 
ponent service transmitted by said second computer system over said communication network, the first computer 
system executes a runtime environment component for producing a result according to said received request, and 
transmits - over said network - a response comprising said result to said second computer system. 
[0021 ] In the context of the present invention a lightweight component is a software program which is able to request 
a runtime environment component sen/Ice, wherein the lightweight component corresponds to this runtime environment 
component service, and wherein the lightweight component is tiny enough to be downloaded from the first computer 
system onto the second computer system via the network connecting the first with the second computer system within 
a time t significantly smaller than the time it would take to download the whole runtime environment component to 
which it corresponds. . . *u 

[0022] The time t shall particularly, but not necessarily, be less than (8 N / Cg) + t^. wherein N is the size of the 
15 runtime environment component in bytes, Cg is the average bandwidth of the network connection between the first 
and the second computer system, and t^ is the time needed to initialize the runtime environment component providing 
the requested service in its respective local environment on the first computer system. In today's commonly available 
network connections between servers and clients the time t wilt typically be about ten seconds. 
[0023] When using networks commonly used at present for the connection of clients and servers this time condition 
20 amounts to a scope of the lightweight component which is - measured In necessary storage space - less than ten or 
even less than five percent of the scope of the totality of the runtime environment components which can be requested 
by it, including any auxiliary software programs which these runtime environment components need to be executed in 
the first computer system. 

[0024] Correspondence of the lightweight component with the runtime environment component service means, in 
25 this context, that the lightweight component must offer the second computer system access to the mntime environment 
component service made available by it. If a plurality of runtime environment component sen^ices Is made available 
by the lightweight component, which will frequently be the case, the lightweight component conresponds to this plurality 
of runtime environment component services in the explained sense. 

[0025] The inventive methods enable a second computer system to use results produced by a first computer system. 

30 The load of holding, maintaining and administrating these runtime environment components, as well as executing these 
runtime environment components, is burdened onto said first computer system. Nevertheless, said second computer 
system can profit from these runtime environment component services as if the relating runtime environment compo- 
nents were present locally on said second computer system. Therefore, additional functionality is provided even to 
those computer systems which are not powerful enough to store and / or execute the full range of mntime environment 

35 components, as for example notebooks, handheld computers, organizers and mobile telephones. Since said first com- 
puter system and said second computer system exchange requests for services and responses to said requests, rather 
than exchanging programming code to perfonn the services, the amount of data transfer between both computer sys- 
tems is considerably reduced. This shortens communication time (on-line time) and leads to faster running software 
. programs on the second computer system. 

40 [0026] The inventive methods are particularly interesting for use with a client/server environment. In that case, the 
first computer system takes over the role of a server, whereas the second computer system is one of the clients. The 
network may be a local network or a wide-area network, as for example the Internet. 
" [0027] As an example, said runtime environment component services may relate to graphic functions, word process- 
ing functions, document editing functions, mathematical functions, table calculation functions, or printing functions. 

45 Said runtime' environment components may be, for example, of the form of application programming interfaces or 
runtime components. j 
[0028] The runtime environment component services offered by the first computer system are requested, according 
to the present invention, by means of a request generated by a lightweight component on the second computer system. 
This lightweight component may issue this request in response to a call of a software program being executed on the 

50 second computer system. Howeven the lightweight component may also be or have a user interface, so that no addi- 
tional software programs need to be executed on the second computer system. 

[0029] The runtime environment components as well as possible software programs calling for their services may 
comprise compiled program^ code to be executed or script code to be interpreted, 

[0030] As a general advantage of the invention, all the characteristics of the runtime environment components re- 
.55 siding on said first computer system, for example a program interface and a mntime environment, can be made fully 
available for use by said second computer system. If new components or releases of components are added to said 
first computer system, these can be made immediately available to the second computer system without any significant 
modifications or additions required on said second computer system. This centra! administration of mntime environment 
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components reduces the load of administration on said second computer system and on a cllenVserver system in 

[003lT" Said request and / or said response sent over said communication network may be compliant with a prede- 
tennined communication protocol. In particular wHh the Internet protocol. ^ , 

5 [0032] inparticularJfthecommunicationnetworkisanopenwide-areanetwork.saidrequestand/orsa.dres^^^^^^^^ 
may be transmitted over secure channels. For example, enciyption / decryption technologies may be applied for the 

communication between said computer systems. 

[0033] said request and / or said response may comprise identification data of said first computer system. .dentif|- 
cation data of said second computer system. Identification data of said runtime environment component service, and 
10 input data to said mntime environment component sen/ice. ... 

[0034] It is to be understood that said first computer system may present said mntime environment component serv- 
ices to an arbitrary number of second computer systems independently from each other. On the other hand, a second 
computer system may transmit its requests selectively to different first computer systems. The communica^n network 
may be of any type suitable for communication between computer systems, including wired and partially or totally 
wireless. The computer systems may be of any type of processing environments, and of any size. They may be em- 
bedded into other systems. . .... 

r0035] The invention can be implemented by a computer system comprising computer program code or apphcation 
code. Computer program code or application code may be embodied In any form of a computer program product. A 
computer program product comprises a medium configured to store or transport ^^^P"*^^;:^^^?'^^ "^^^ 
computer-readable code may be embedded. Some examples of computer program products are CD-ROM disks. ROM 
cards magnetic disks or tapes, service on a network, and carrier waves. The computer program product may also 
comprise signals which do not use carrier waves, such as digital signals transmitted over a network. The computer 
program product may then be implemented as any transmission link, such as a connection to the Internet, or any LAN. 
WAN, telephone network, or the like. ^. * +u« 

r0036] Further, the invention comprises runtime environment components for use with a method according to the 
invention. In particular, the invention also comprises a data base comprising runtime environment components relating 
to said services according to any of the inventive methods. 
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BRIEF DESCRIPTION OF THE DRAWINGS 
[0037] 



piQ 1 is an illustration of one embodiment of the present invention with a plurality of user devices 

that each can execute a lightweight component that corresponds to at least one component 
35 on the server computer system; 

PiQ 2 is a more detailed illustration of one embodiment of the present invention with a representative 

user device that executes a lightweight component that corresponds to at least one component 
on the server computer system; 



pjg 3 Is a process flow diagram for one embodiment of the present Invention; 

pjg 4 is an architecture diagram for one embodiment of the present invention; 

45 Figs. 5A to 5D are a sequence diagram for a JAVA-based implementation of one embodiment of the present 

invention; 

Fig..6. is a class diagram for the embodiment of the present invention illustrated in^igs. 5A to 50; 

50 Pjg 7 is a cross-reference between Tables in the description and selected interfaces in Fig. 6; 

Figs. 8A to 8C are a cross-reference between Tables in the description and selected interfaces in Fig. 6; 

pjg 9 is a cross-reference between Tables In the description and selected Interfaces In Fig. 6; 

^ Figs. 10A and 10B are a cross-reference between Tables in the description and selected interfaces In Fig. 6; 

pig^^ gives a general oven/iew of an implementation of the invention; 
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Fig 12 . illustrates the processing of a request by a remote server framework; 

Pig 13 ^ illustrates an implementation of a lightweight component; 

5 Pig 1 4 illustrates the transparent access via an object component model; 

Pig 15 illustrates an implementation of a visual lightweight component; 

P,g -I6 illustrates remotely drawing; 

10 

Pig 1 7 illustrates accessing an API; 

Pig 18 illustrates the creation of a Java bean lightweight component; 

Fig. 1 9 illustrates relating a StarOfficeBean frame window; 

Fig, 20 gives a flow chart for an example using the present invention; 

Fig 21 illustrates a client's view of a non-visual lightweight component; and 

Pig 22 illustrates a client's view of a visual lightweight component; 

Fig. 23 shows a schematic representation of the inventive method In overview; 

shows a flow chart: initial communication of a first and a second software program; 

Pig 25 shows a flow chart: creation of a stub; 

p,g 26 shows a flow chart: creation of a proxy; 

p,g 27 shows a flow chart: arranging a stub and a proxy; 

showsaschematic representation ofacomputer system to be used in the scope of the present 

invention; 

shows a representation ot a client-server system to be used in the scope of the present inven- 
tion; 

pjg 30 shows a flow chart: calling of a Stub; 

Pig 31 shows a flow chart: calling of the second program through the stub; 

pjg 32 shows a flow chart: binding a stub and a proxy; 

45 Fig. 33 r shows a flow chart calling the second software program from a first software program via a 

proxy and a stub; 

shows a flow chart translomiing and transmitting a command from the first software program 
to the second software program; 

shows a schematic representation of an interceptor ananged between a stub and a proxy; and 
shows a flow chart: use of an interceptor furictlori in an an-angement of stub and proxy. 
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Fig. 28 
Fig. 29 
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Fig. 34 

Fig. 35 
Fig, 36 
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r>FTAILED DESCRIPTION 

r00391 According to one embodiment of the present invention, a user can access and use applications or services, 
e f applStion 11 2 In a suite of applications 1 20. on server computer system 1 00 from almost any available device, 
e g" a!y onTo?a portable computer 1 02A, a mobile telephone 102B. a workstation 102C. a home Personal computer 
(PC) Zd a personal digital assistant 102E. or an Internet cafe machine 102F. No longer .s a user limited to using 
either woiKstations and/or portable computers with suite of applications 1 20 installed thereon. 
S] For example, a user on a vacation overseas suddenly realizes that the presentation her boss is going to 
deliver the next morning contains a critical error. The user drops by an Internet cafe and from any "^f hine 1 02F at 
the cafe accesses the presentation via server computer system 1 00. and makes the necessary c°^^e<=J°"^ "^^^^^ 
pications written, for example, in a visual basic programming language and/or the C++ programming language even 
though only a browser is available on machine 1 02F. 

004?] in another scenario, the user is having dinner at a friend's house, and gets an u^ent ^=^"9 ^^^^^^ 
Z can be assessed via sen/er computer system 100 must be revised that evening. The revisions not jeq""^^ 
rchv^oibutmetriptott^e office and back isavery unwelcome prospect. Usingthe friend's^ 
Semet se^/lce provider, the user wori« on the report without leaving his friend's home even though no software or 
accessing application suite 120 is available on PC 102D. The user interface on PC 102D and the application capability 
is that same as if tiie user were executing the application at the office. » 
r0042] Another user is expecting an important document, but the user has a business appointment outside ttie office. 
Te document arrives by e mail while tt.e user is In transit. Using a PDA 1 02E while on the train, the user accesses 
ie e maTusJng sender computer 1 00. reviews the document, and then re-directs tiie document to the fax machine at 

lit Tcui-erwou^ liSSmeet wHh a usertom^^^^^ 

know whether anyone scheduled tiie time while the user was away from tiie office, and now the office closed. Using 
ar^obiletelephone102B,theuseraccesseshisup-to-the-minute calendar via server computersystemlOO and sched- 

He'^STn one embodiment, using a web browser and an Internet connection, the user simply logs on to a 
web server 111 and proceeds as though everything were locally resident on his/her machine. While execution actually 
Takes p7ace on server computer system 100, this fact is transparent to the user. Similarly, local services available on 
30 a client system, including devices like printers and local storage, can be utilized In a transparent manner. 

m045] In addition to using browsers, users can access applications on seiver computer system 100. sometimes 
Ssen^er 100. from Wireless Application Protocol (WAP) devices, which Include mobile phone 102B and perhaps 
Sa 102E. Because of the limited capabilities of devices 102B and 102E. functionality .s f 
system tt^at can run a full browser. Accordingly. In one embodiment, users are able to ^'7.*'°™' ^"^."^^^^^^ 
users dont have full editing capabilities in tiiis embodiment, However, users can use mobile phones and PDAs to 

manaoe ttieir data and the users can direct the movement of infomiation to ottier devices. 

TomT Hence, a user of any one user device 1 021. where 1 is A to G. of a pl^^^^^^ 

an application 11 2. or any otiner application in suite 1 20 tiiat can include for example a word processing appl'oati^^ 
spraaSsheet application, a database application, a graphics and drawing application, an e-mail ^PP'-cation. a contecte 
mILger application, a schedule application, and a presentation application, as if tiiat app^^^^^^ 
on user de^ce 1 021. One office application package suitable for use witti this invention, is the STAROFFICE Application 
Suravile f^m Sun MIcrosSems. 901 San Antonio Road. Pato Alto. CA. (STAROFFICE is a trademark of Sun 
Mtorasystems. Inc.) The user has access to the functionality of application 112 even m situations where user device 
1021 has neittier ttie memory capacity nor the processing power to execute application 112^ 
[0047] AS explained more completely below. In each of the above examples, a ''Sf'**^'^^* '^°"'P°"^" .^.^^ ^ 
s e Jer stored locally In a memory of user device 1 021. or Is downtoaded from server computer system 1 00(F.g. 2) to 
meS iTin user device 1021. Lightweight component 230, in the embodiment, is loaded n a browser^ to commu- 
: Se.over a network, e.g.. enterprise networ_k 103, Internet 106, or a combination_of the two 103/106. w.ti. application 
112 that is executing on server computer system 100. . ^ ^ o^^^^r 

0047 Lightweight component 230.as explained more completely beto^^ 

ighJeight component 230, in one embodiment, maps visual display Instmctions from ^PP'''^*""^ ^ execu.ng on 
server computersystem 100 to a platform dependent graphic layer that In torn generates a user nterface on display 
screen 295 of monitor 21 6. The user Interface tor application 112 is similar to the user interface that the user would 
reeTappnc^ion 112 were executing locally on device 102i. The interfaces may not be identical if user device 102i 
55 has limited Input/output capability, e.g.. user device 102i is a mobile telephone. „.„„„„„.,»or 
[0049? Whenlightweightcomponent230receivesaninputeventfromthewindowingenvironmentexecu^^^^^^^ 
device eg the JAVA Abstract Endowing Toolkit (AWT), lightweight component 230 transmits the event to apptication 
?iX p;ocesIng. Here, tiie input event could be selection of a menu Item, configuration of a menu, a keyboard .nput. 
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a mouse input, or any other input event supported by aPf^^f J^ J , lightweight 

l„anM<^ F« e^mple. II Ih. inanK*,«s ar. to '^^T « ««..p»«.K In the user 

printer 217. n„nont9qn sometimes called a thin client, is software, which, upon execu- 

[0053] As used herein a lightweight component 230, ^"^^ J^''^^^ e.g., an application orsen/ice 

L,isabletoprovideinputtoand receive outpu^from^a^^^^^^^^ 

112 that is sometime called a mntime sSeJ. 102i via a network 103 and 106 within a 

downloaded from --P'^^-V^^^^^^^^^^ component 112. 
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* «,«««nor,t 119 in hvtes Co is the average bandwidth in bits per second 
where N is the size of runtime environment «=°'"P°"^* '^'^^ ^^^^^^^^ 1021, and t^ is the time 

of the network connection between on first computer system 

sttr;rn,:ra==n^^^^^^^^ 

S^HenusingnetworKscommoniyusedatpresentfoMh^^^^^^^^ 
ivesa,ightweig„ 

rei^hTcXnStxrdrnr?^^^^^^^^ 

to be executed in first computer system 100- environment component 112 means. In this con- 

[0056] Correspondence of lightweight ,1 ° ^^0!!^^^^ 102i acceVs to the runtime environment 

text, that lightweight componem^^^^^^^^ 

component service made available by «»'"P°"f"i,;^''- " ^ P., f,J^„pn,,„ u„ the case lightweight component 230, in 
IS made available by the "S^-^'^IJ th'e expi^ned sense, 

this embodiment, corresponds to this pluraMy of runttme romi y executed on a client device 

[0057] Hence, in this embodiment, the software system includes two paite^^^^^^ 

io2i.ind a second par, 120 residing -'^^''^^"'^ °" ^^^^^^^^ Sle environment compo- 

makes up the mntime environment, which in this embedment, c^^^^^ 

nents. which are able to provide services F"*^'^":^^; f ^f^^, 1 some Les «lled user device 1 02i. 
necessary communication tools in order to communK^te^^^^^^ 
[0058] Theotherpart230.beingexecutedoncl.errtdevK^^^^ 
inrequestingaruntimeenvironmentcomponentsenncebe,^ 
system is by far larger in size than the dient^ part t^^^^^^^ 

JfS'SfSaC^i^^^^^^ 

and uses minimal system resources (CPU power, memory). intprfarp (M>\\ for anv application program 

syslem100.VarioosWesolligW«8«MoomponsnB2»m»^ „„icn pravldM . spoclfic rosult to 

aco^sos a p.*"l.r Mon.llt,. ' foncHonilt,. 
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103/106 first computer system 100 executes a runtime environment component 112 for producing a result according 
to the received request, and transmits, overnetworic 103/106, a response comprising the result to the second computer 

m06lT ^Herein, computer software programs and parts thereof, which are called during execution of a lightweight 
component 230, are herein referred to as runtime environment components 1 20. The functionality provided by runtme 
environment components 1 20 to lightweight component 230 are herein referred to as runtime 
services The size of runtime environment components 120 renders a distnbution over Internet 106 difficu t. Runtime 
environment components 120 may be implemented in any suitable fom>. Runtime environment components 1 20 may 
consist of compiled software program code to be executed or of script code in any programming language to be inter- 
preted before execution by a compiler. Runtime environment components 120 are typically stored and administrated 
on server computer system 100. au < 

[0062] Lightweight component 230 makes runtime environment component services, that means the unctionalities 
provided by mntime environment components 120. available for use without integrating componeirts 120 into ligh^ 
weight component 230 and without distributing components 1 20 together with lightweight component 230 to the place 
IS of execution of lightweight component 230. for example, client device 1 021. „ , , 

ro0631 Further the full functionality of the runtime environment components 120 is available for all kinds of clien 
devices independent of whether the client devices are powerful enough to store or to execute a mntime environment 
component 112. Further, the user of a client device Is not charged with the problem of whether a specific runtme 
environment component 11 2 is available on client device 102i. 

[00641 The holding, maintaining and administrating runtime environment components 120. as well as executing runt- 
ime environment components 120. Is placed on first computer system 100. Nevertheless, second computer system 
102i can profit from these runtime environment component sen/ices as if the corresponding runtime environment com- 
ponents 120 were present locally on second computer system 1021. Therefore, additional functionality is provided even 
to those computer systems, which are not powerful enough to store and / or execute the full range of mntime environ- 
ment components 120, as for example notebooks, handheld computers, organizers and mobile telephones. 
[00651 Figure 3 Is a process flow diagram for one embodiment of method 300 of this invention. Initially, a user of 
device 1021 issues a request to use applications 120 over networt< 103/106 to web server 111 . The transmission of the 
request over the network 103/106 is perfomied according to a predetermined transmission Protocol. In response to 
the request from user device 1 021, web server 112 determines in lightweight component available check operation 301 
whetherthe request was from lightweight component 230. If the request was from lightweight component 230 process- 

Ing transfers to login operation 310 and otherwise to device capability check operation 302 Device capability check 
operation 302 detemiines whether user device 102i can execute and use lightweight component 230, e.g., is there a 
lightweight component 230 available for the general type of user device 1021, and Is the operating system, processor, 
and memory of specific user device 1021 sufficient to execute and support lightweight component 230. This information 
may be included in the initial request, a process on server computer system 100 may communicate with user device 
1021 to obtain the information, or alternatively, the request may include an identifier that Is used to access a database 
todeterminethecapabilltlesof user device 1021. . ^ t„ 

r00661 If user device 1 021 is capable of executing and supporting lightweight component 230, processing transfers 
to download component operation 304 and othenwise to return error operation 303. Return error operation 303 sends 
an appropriateerror message to user device 1 021 to inform the user of the incompatibility between requested applicaton 

1 1 2 and user device 1 021. . _ _ _ 

[00671 Download component operation 304 downloads, and installs if necessary, lightweight component 230 on user 
device 1021. Thus, prior to starting login operation 310, lightweight component 230 is available on "ser device 02i. 
[0068] m response to the request to access applications 120, In login operation 31 0. a connection is established 

45 over networi^ 103/106 to a daemon executing on server 112. 

The daemon returns a handle to a daemon service factory to lightweight component 230. 

[00691 Upon receipt of the handle to the daemon service factory, lightweight component 230 issues a request to the 
service- factory to-initiate-execution of a login service on server computer^systemJOO. Upon activation of the login 
service lightweight component 230 transmits a user identification, a password, and options for mntme environment 
components 120 to the login sen/ice. The login service on sender 100 validates the user login in login operation 310 

and transfers to initialize application operation 320. ' ' \, ■ . 

[00701 Start application operation 322 within operation 320 activates a service factory for mntme environment com- 
ponents 120 on sender 100 and returns a handle to this service factory to lightweight component 230. Opeiaton 322 
transfers processing to create user interface operation 326 within initialize application operation 320. 
[00711 In create userinterface operation 326. lightweight component 230 issues a request to the mntme environment 
components sen/ice factory to start an infiastmctijre generation senrice. In response to the request, the service factory, 
executing on sen/er computer system 1 00, activates ttie infrastmcture.generation service, and returns a handle to this 
service to lightweight component 230. Processing transfers to create visual infrastmcture operation 327. . 



so 



25 



30 



35 



40 



SO 



55 



9 



EP1 130 510 A2 



'roo76rioSlica«on 112 reads the loaded document, and generates a display layout that is sent to the server window 
SlnStfeTe^er^Sowobi^ 

230 The remote frame window generates commands to a device dependant graphic layer, e.g.. the JAVA AWT, whicn 
in turn generates the user interface on display screen 295 of monitor 21 6, .n th.s enjbod.'"^"^ 
rooTTi If user device 1021 has limited input/output capability, the user may be able to only read the document, or 
the J^cument^^^^^ output deJice if application 112 includes such a capability, e.g a capability to 

n the document. The scroll action is interpreted by the windowing environnien^n user device a scroll com 

mind is set bv the windowing environment to the remote window frame of lightweight component 230. 
moS 1The?emot™^^^^^^ 

rieLr I ^Te ler^^^^^^^^^ P o'^^sses the event received and generates an application event that in turn 

?0°0^91 in one embodiment, the transmissions over network 103/106 between lightweight component 230 and server 
00 are encTpted according to known technologies. Further, in another embodiment, digital ^T^^'^'^'^^^^. 
ildecerSSuon of the request mechanism being established on the cl-i^^^ 

' ■ SoMrTS^ieofalightweightcomponent230doesnotincreasewiththenumberofaccessedruntim^ 



'"^""^l one embodiment of the invention, the STAROFFICE application suite is utilized as f J^J^^^^^^ 
ents 120 on server computer system. Figure 4 is an Illustration of a layer architecture of the STAROFFICE 

impTemen^^^^^^^^^ some functionality or behavior. For example on systems where no natve mult, threading 

so ESng Z aroetKltem /pecific resources like files, memory, sockets, pipes, etc. The OSL ,s a very thin layer 

711'! tl^e'^rSme W within layer 401 provides all semi platfom, independent functionality. There is an imple. 
Stion for Srclasses provided^Routlnes for conversion of strings to d«terent character sets are implemented. 

. ;rr™rrt::s?^^^^^ 

SrSm^te ^^^^^^^^ Shown as bridging infrastn^cture layer 402 and system abstraction 

!ayTL ReZ VCL SI all user interface events and sends responses to user Interface events over network 
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tolightweight component 230 on another computer, which then displays the actual output as described atove Remote 
VCL encapsulates all access to the different underlying GUI systems on different client devices Remote VCL .s a high 
level definition of a graphic device defined as a set of interfaces. Remote VCL is based completely o" « 
infrastructure. This gives remote VCL the ability to map functionality, which a client system is unable to support, to a 
service component on the server side emulating this functionality. „„„ui„„ «di 

[00871 The implementation of remote VCL is platfomi independent and Includes an ob|ect onented 2D graphics API 
with metafiles, fonts, raster operations and the whole widget set use by the STAROFFICE application suite. This ap- 
proach virtually guarantees that all widgets have the same behavior independently of the used GUI system on ttje 
different platfomts. Also the look & feel and the functionality of the widgets are on all platfomis he same Remote VCL 
includes a mapping to the interface of the lightweight component that is described more completely below. Since this 
mapping is platform independent, remote VCL does not access any native window system. 

roOMl Infrastructure layer 402 is a platfomi independent environmentfor building appiicaton. components and serv- 
ices, llayer 402 covers many aspects of an object oriented API for a complete object oriented platform including a 
component model, scripting, compound documents, etc. 

r0089] To malte the usage of system resources like files, threads, sockets, etc. more convenient the virtual operating 
system layer encapsulates all the functionality of the operating system layer into C++ classes. The tools libranes are 
different small libraries building up a set of tool functionality. This includes a common implementetion for handling date 
and time related data. There is an implementation for structured storages available. Other implementations provide a 
aeneric registry, typesafe management and persistence of property data. ■ . 

[0090] Universal network objects are a component technology that does not depend on any graphical subsystem, 
but areheavily based on mulfithreadingandnetwori<communicationcapabilitles. The system consistsofseveralpieces. 

An IDL-Compiler. which generates out of the specified definition of an interface a binary representation and the asso- 
ciated C-Header or JAVA technology files. The binary representation is platfomi and language independent and is at 
runtime used to marshal arguments for remote function calls or to generate code on the fly for a specific a"g"age to 
access the Implementation provided by the interface. Many parts of the UNO technology are implemented as Ulv^O 
components. This helps to create a very flexible system and also the extension of the system at runtme. For example, 
by providing new bridges or communication protocols, UNO provides transparent access to components over the 
networic or locally. For a more complete description of bridges, see commonly filed and commonly assigned European 
PaSt ApSn. entitled "A I-IETHOD AND SYSTEM FOR DYNAMICALLY DISPATCHING FUNCTION CALLS 
FROM A FIRST EXECUTION ENVIRONMENT TO A SECOND EXECUTION ENVIRONMENT." of Markus Meyer (At- 
torney Docket No. 85882), which is incorporated herein by reference in its entirety. For the communication over the 
networtc HOP can be used, if the components are realized as shared libraries, the components can be oaded into to 
the process memory of the application and every access of the component is just like a function call vmthout any 
marshalling of arguments which is required for remote function calls. 

[0091 1 The Universal Content Broker (UCB) allows all upper layers to access different kind of structure content trans- 
parentiy. The UCB includes a core and several Universal Content Providers, which are used to integrate drtterent 
access protocols. One implementation provides content providers for the HTTP protocol. FTP protocol. WebDAV pro- 
tocol and access to the local file system. ^ . 

[00921 The UCB not only provides access to the content, but also the UCB provides the associated meta infomiation 
to the content. Actually, synchronous and asynchronous modes for operations are supported. A more complete de- 
scription of the UCB is provided in copending, cofiled, and commonly assigned European Patent Application, entitled 
■A NETWORK PORTAL SYSTEM AND METHODS" of Matthias Hutsch. Ralf Hofmann and Kai Sommerfeld (Attorney 
Docket No. 85880). which is incorporated herein by reference in its entirety. 

[0093] Framewori< layer 403 allbw^ the reuse of implementations in different applications. Uyer 403 provides the 
framewori< or environment for each application and all shared functionality like common dialogs, file access or the 
configuration management .. . aux r*. 

[0094] The application framewortc library in layer 403 provides an environment for all applicattons. All functionality 
shared by all applications and-not provided by any-other layerJs.reallzed here. For the framewori<„ey§ry visual appli- 
cation has to provide a shell and can provide several views. The library provides all basic functionality so only the 
application specific features have to be added. ^ ^ ,■ xk= t-^rviato 

[0095] The application framewori< library is also responsible for content detection and aggregation. The template 
management Is provided here and the configuration management too. The application framewori. library is in some 
areas related to the compound documents, because of the functionality for merging or switching menu- and toolbars. 
Also the library provides ttie capability for customization of all applications. 

[0096] The SVX library in layer 403 provides shared functionality for all applications, which is not related to a frame- 
wori< So part of the library is a complete object oriented drawing layer, which is used by several applications for graphic 
editing and output. Also a complete 3D-rendering system is part of the drawing functionality. The common dialogs for 
font selection, color chooser, etc. are all part of tiiis library. Also ttie whole database connectivity is realized here. 
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play software program with a graphical user intertace f*^"''. ' "° ^ rendered by a browser. This 

example of one Implementation is a Java bean, which is embedded in an HTML Pf9e ana renae ^ 
Java Ln represents a view (in a window) Of an Office a^^^^^^^^^ 

played in Figures 5A to 5D Is for a JAVA^n^fted s^^^^^^ ^^^^^^^^ instantiated. 

connector with an -^S^'-^f -JP^'-^ff " J^J^^^^^^^ its handle to object Connection 512. a 

r^^n^reLrhe^lS^^^^^^^^^^^ 

120 and lightweight component 230 can J'^^^J^^^^^^^^ StarBean 511 calls method 

[0108] UponobjectConnectionSIZr^^^^^^^^^^^ 

getObject("BeanSen,ice-),ntheAPIofol^,ertO^^ 

532 is returned to object SterSean 511 a d^^^^^^^ 

sTsTX™ to"^^ -0 can create windows and any o.er 
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comoonents on client device 1 02i needed by application suite 1 20. ^. . « r. n 

Sr ?o create the infrastructure needed to run application suite 120 on server 100, object StarBean 512 calls 
■method createBeanWindow of object BeanService 532. Object BeanService 532 then ca Is method crea einstance 
?Rm?tamewindoW) in the API of object CllentFactory 51 5 and object ClientFactory 51 5 m.tiahzes remote frame win- 
dow obiect 514 on user device 1021, . « • » 

[oTl1] Following creation of remote frame window object 514 on user device 1021, ob,ect BeanSen/.ce 532 calls 
nitialize method init(RmFrameWindow) to create an instance of object BeanWindow 534 to support remote frame 
Sdow object 51 4. To further initialize object BeanWindow 534, object BeanWindow 534 sends one or more quenes 
to object RmFrameWindow 51 4 to detemiine the display capabilities of user device 1 02i. „,,„e„„, 
r0112] Finally, object BeanService 532 calls method init(Window) to instantiate and initialize object BeanFrairie 533 
for application suite 120. Object BeanFrame 533 controls the environment for this instance of application suite 1 20. 
For example, object BeanFrame 533 controls the lifetime of components of the user interface on client device 102i 
used by application suite 120, the loading of such components, and so on. A handle to object BeanFrame 533 is 
returned to and stored by object StarBean 511. , _., ^ n 

0113] upon receiving the handle to object BeanFrame 533, object StarBean 511 calls mett,od loadDocument(url 
in the API of object BeanFrame 533 (Fig. 50). Here, uri is an address, e.g.. a unifomi resource locator, of the document 
requested by the user. Object BeanFrame 553 can detemiine which component is requested in a number of ways. For 
example, object BeanFrame 533 can ask the underiying transport component for a content type, or perhaps look at 
the first few bytes of an available number. As a last resort, the extension of the address is used by object BeanFrame 
533 to determine which component within application suite 1 20 to launch. Independent of the technique used to identify 
the requested runtime environment component, after identifying the component in this embodiment, object BeanFrame 
533 calls method init(Window) in component StarWriter 535 in the STAROFFICE application suite 
[01141 in this embodiment, the component Initialized by BeanFrame 533 must use the remote VOL and only it to 
handle user interface input/output. However, no other modifications are required to work in this environment. Any pnor 
art application that works in a windowing graphic user Interface could be used in place of component StarWnter so 
along as it included the functionality provided by the remote VOL and used only that functionality to handle user interface 

roilS]"' After component StarWriter 535 is initialized, object BeanFrame 533 calls method load{url) in the API of com- 
ponent StarWriter 535. Component StarWriter 535 loads the document at the address specified m method load and 
perfomis methods readDocument and do Layout. Upon completing the window layout, component StarWnter calls 
method show in the API of object BeanWindow 534, and in response, object BeanWindow 534 calls method show in 
the API of object RemoteFrameWindow 51 4. Object RemoteFrameWlndow 51 4 causes the window generated by com- 
Donent StarWriter 535 to be displayed on display screen 295 of user device 1 02i. , ^ ^ 

r0116] Similarty, astheuserof user device 1021 perfomr,san input action on the infomiatlon displayed, the appropnate 
nput event is transmitted from object RmFrameWindow 514 to object BeanWindow 533 and in turn to component 
SterWriter 535. Conversely, each call to a method in the graphic user interface, e.g., method drawLine, method draw- 
Text, etc., is made to the API of object BeanWindow 533 and a corresponding method call Is made to a method in the 
API of object RmFrameWindow 514 by object BeanWindow 533. 

[0117] Figure 5D is an example of the processing of a mouse click by the user. In this examine, the mouse cl ck 
event is handled by the AWT panel, which in turn calls method onMouseCrick(x.y) of object RmFrameWindow 514. 
Remote frame window object 51 4. in response, calls method MouseEvent(x,y) of object BeanWindow 534. 
[01181 Object BeanWindow 534 mns method processUlevent to detemiine the particular event that occurred, and 
calls an appropriate method in the API of component StarWriter 535. In this example, object BeanWindow 534 calls 
method applicationEvent(ButtonClicked) in the API of component StarWnter 535. . , ^ . , 

[01191 In response to the method call, component StarWriter 535 runs methods processApplicatonEvent, re-layout, 
and re-draw. Method re-draw calls the appropriate methods In object BeanWindow 534 that in turns issues correspond- 
inq method calls to object RmFrameWindow. . . ^ . i . . 

—[01201 In the embodiment of Figures 5A to-5D,-objects.531 to 534 are.an.example of a user interface infrastructure 
ttiatreceivesgraphic user interface events from user device 102i, and thatthe njntime environment component service 
sends remote graphic user interface commands. Here, commands are the calls to the various methods in the interfaces 
of the objects. A local command is one on system 100. A remote input action command is a command sent from 
lightweight component 230 on user device 1 021 to the user Interface infrastructure on system 1 00 in response to a user 
input A remote output command is a command sent by the user interface infrastructure on system 100 to lightwe.gh 
component 230 on user device 102i. Similariy, object BeanFrame 533 is an example of a local frame object, and object 
BeanWindow 534 is an example of a local window object. Thus, objects and actions on system 100 are considered 
local, while objects and actions on user device I02i are considered remote 

[01211 Figure 6 Is one embodiment of a class diagram for the sequence diagram of Figures 5A to 5D. Figures 7. 8A 
to 80, 9. 10A and 10B illustrate one embodiment of interfaces, stmctures, enumerations and excepUons associated 
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with each interface Illustrated in Figure 6 and give a corresponding Table number for each in the description thatfollows. 
ThS namJs Of rJeS. e.g.. Interfaces, structures, exceptions, enumerations, strings, constants, etc.. are .nd.cat.ve 

TirT^eli^S^X^tZten^o., remote frame ^ndow class RmFrameWindow (Figu. 6) includes a 
emote frle wirw interface XRmFrameWindow (Table 1 ) and a remote output device interface XRmoutputDe^ce 
Zle 8 interface XRmFrameWindow inherits from interface XInterface (Table 2 and F.g. 7) and uses .n erface 
SeiSr4) interface XRmFrameWindow. in the embodiment of Table 1, includes methods Create. Re- 
SSoS^^Setm. Show. SetClientSize. GetClientSize, SetWindowState. GetFontResolution GetFrameResdu- 
tns tX S^rrese^^^^^ SetAlwaysOnTop. ShowFullScreen, CaptureMouse. SetPo.nter, SetPomterPos, Beep, 
SkbTn^^XS^^^^^^ SetMinClientSize. MouseMoveProcessed. and KeylnputProcessed. (Here.n, an ,tal- 
iri7Pd Dhrase and the same phase that is not italicized are the same phrase.) ^ ...^ 

SlSr^^^^^^^^^^^ notifies the client, that the window connected to this interface i-ot n-^^^^^^^ 

Server anymore. Whether the real window is destroyed and a new one created on the next call of Create or the real 
window Is cached is up to the client implementation. 



TABLE 1.: Interface XRmFrameWindow 



35 



40 



typedef sequence< IDLKeyNamelnfo, 1 > KeyNameSequence ; 

interface XRmFrameWindow : 

com: :sun: :star: :uno: : XInterface 

{ 

[oneway] void Create ( [in] unsigned long nWinBits, 
[in] XEventHdl xEventlnterf ace, [in] any 
aSystemWorkWindowToken, [in] XRmFrameWindow 

xParent ) ; 
[oneway] void ReleaseWindow { ) ; 
[oneway] void SetTitle( [in] string rTitle ); 
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[oneway] void Show( [in] boolean bVisible ); 
[oneway] void SetClientSize ( [in] short nWidth, [in] 

short nHeight ) ; 
void GetClientSize.( [out] short rWidth, [out]' short 

rHeight ) ; 
string GetWindowState ( ) ; 

[oneway] void SetWindowState~( [in] string aState ); 
void GetFontResolution{ [out] long nDPIX, [out] long 
nDPIY ) ; 

RmFrameResolutions GetFrameResolutions ( ) ; 

[oneway] void ToTop ( [in] unsigned short nFlags ); 

[oneway] void StartPresentation ( [in] boolean 

bStart,[in] unsigned short nStartFlags ); 
[oneway] void SetAlwaysOnTop ( [in] boolean bOnTop ); 
[oneway] void ShowFullScreen ( [in] boolean bFullScreen) ; 
[oneway] void CaptureMouse ( [in] boolean bMouse ); 
[oneway] void SetPointer{ [in] unsigned short 

ePointerStyle ) ; 
[oneway] void SetPointerPos ( [in] short nX, [in] short 

nY ) ; 

[oneway] void Beep ( [in] unsigned short eSoundType ); 

void GetKeyNames ( [out] KeyNameSequence rKeyNames ); 
[oneway] void Enable ( [in] boolean bEnable ); 
[oneway] void Setlcon { [in] short IconID ); 
[oneway] void SetMinClientSize ( [in] short Width, [in] 
short Height ) ; 



[oneway] void 
[oneway] void 



MouseMoveProcessed { ) 
KeylnputProcessedO ; 




55 [0124] Interface Xlnterface (Table 2) is the base interface for other interfaces and provides lifetime control by refer- 
ence counting. Interface Xlnterface also provides the possibility of querying for other Interfaces of the same logical 
object. Logical object in this case means that the interfaces actually can be supported by mtemal, i.e., aggregated, 
physical objects. 



15 



EP1 130 510 A2 



[0125] MethodQiiery/nte/fece/ninterfaceX/nterfacaqueriesf^ 

Increases a reference counter by one. while method release decreases the reference counter by one. When the ref- 
erence counter reaches a value of zero, the object is deleted. 



TABLE 2.: INTERFACE XInterface 
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/** queries for a new interface to an existing 
object. 

@param aUik 

specifies the Uik of the interface to 

be queried. 
@param ifc 

returns the new interface if the method 
succeeds. 

ereturns 

<TRUE/> if the UNO object to which this 
interface referred supports the 
interface denoted by parameter aUik. 

*/ 

any querylnterf ace ( [in] type aType ); 
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//boolean querylnterf ace ( [in] 
//com: :sun: :star: :uno: :Uik aUik, 
// [out] any ifc ) ; 

// 

/** increases the reference counter by one. 

[oneway] void acquire {); 

// 

/** decreases the reference counter by one. 

When the reference counter reaches 0, the object 
gets deleted. 

[oneway] void release (); 



10126] One embodiment of structure Uik in interface XInterface is presented in Table 3. 

TABLE 3.: Structure Uik 



/** specifies- a~universal -interface, key. 

An UIK is an unambiguous 16-byte value for every 
interface. 

V . • 

struct Uik . . • 
I 
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// : 

// specifies a 4 byte data block, 
unsigned long ni_Datal; 



// 

/// specifies a 2 byte data block, 
unsigned short m_Data2; 



// 

/// specifies a 2 byte data block, 
unsigned short m_Data3; 



// 

/// specifies a 4 byte' data block, 
unsigned long m_Data4; 



// 

/// specifies a 4 byte data block, 
unsigned long m_Data5; 



}; 

//=== 



roi271 Method Create in interface XRmFrameWindow of class RmFrameWmdow {P\g. 6) includes as an input a 
reference to an event handler interface XEventHdl (Table 4). Class BeanWindow (Rg. 6) also uses event handler 
interface XEventHdl. In this embodiment, interface XEventHdl inherits from interface XInterface (Table 2) and uses a 
stmcture RmDropFileEvent (Table 5). Interface XEventHdl includes methods MouseButtonUp, MouseButttonDown, 
MouseMove. MouseWheel, Keylnput, KeyUpi Paint. Resize. GetFocus. LoseFocus. Close, QueryDropFile, DropF.le, 

[Siar One"embodiment of structure RmDropRleEverrt that is passed In the call to method RmDropFileEvent is 
presented in Table 5. 
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TABLE 4.: INTERFACE XEventHdl 



interface XEventHdl : com: : sun: : star: :uno: rXInter face 



[oneway] void MouseButtonUp ( [in] short nX, [in] short 
nY, [in] unsigned short nMode, [in] unsigned short 
nCode, [in] unsigned long nSysTime ); 

[oneway] void MouseButtonDown ( [in] short nX, [in] 

short nY, [in] unsigned short nMode, [in] unsigned 
short nCode, [in] unsigned long nSysTime ); 

[oneway] void MouseMove( [in] short nX, [in] short nY, 
[in] unsigned short nMode, [in] unsigned short 
nCode, [in] unsigned long nSysTime ) ; 

[oneway] void MouseWheeK [in] long nX, [in] long nY, 
[in] unsigned short nCode, [in] unsigned long 
nSysTime , [in] long nDelta, [in] long 
nNotchDelta, [in] unsigned long nScrollLines, [in] 
boolean bHorz) ; 

[oneway] void Keylnput( [in] unsigned short nKeyCode, 
[in] unsigned short nChar, [in] unsigned short 
nCount ) ; 

[oneway] void KeyUp ( [in] unsigned short nKeyCode, 

[in] unsigned short nChar ) ; 
[oneway] void Paint ( .[in] long nX, [in] long nY/ [in] 

long nWidth, [in], long nHeight ); 
[oneway] void Resize ( [in] short nWidth, [in] short 

nHeight ) ; . 
[oneway] void GetFocus.O; 
[oneway] void LoseFocusO; 

boolean QueryDropFi'leT"[inour]- ^ 

RmDropFileEvent rDropFileEvent ) ; 
boolean DropFile( [in] RmDropFileEvent 
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aDropFileEvent ) ; 
[oneway] void Close (); 

[oneway] void UserEvent ( [in] unsigned long EventID, 
[in] any Parameter ) ; 

}; 



TABLE 5. Structure RmDropFileEvent 



typedef sequence< string > FileNameSequence; 



struct RmDropFileEvent 



{ 



short 
short 

FileNameSequence 
unsigned short 
unsigned short 
byte 
boolean 



nX; 

nY; 

aFileNameSequence; 
nDropAction; 
nSourceOpt ions ; 
nWindowType; 

bIsDefault; 



); 



[0129] structures used In interface XRmFmmeWindow (Table 1 and Fig. 7) Include structure RmFrameResolutions 
(Table 6) and structure IDLKeyNamelnfo (Table ?). 



20 



EP1 130 510 A2 

TABLE 6/: Structure RmFrameResolution 



struct E^FraiueResolutions 



long 
long 
long 
long 

unsigned short 



DPIx; 

DPIy; 

FontDPIx; 

FontDPIy; 

Depth; 



TABLE 1 . : Structure IDLKeyNamelnfo 



struct IDLKeyNamelnfo 
{ 

unsigned short nCode; 
string aName; 

}; 



[01 30] As illustrated in Fig. 6, class RmFrameWindow includes remote output device interface XRmOutputDevice 
(Table 8) -Interface XflmOuipii^Dewce inherits from interface Xlnterface.(Jab\e 2l and uses structures.lDLFontMetnc^ 
■ Data KemPair IDLFontData. IDLFont (Table 9). In the embodiment of Table 8. interface XRmOutputDevice includes 
methods Quer^SvOutputDevlcePtr, SetClipRegion. ResetClipRegion. GetResolution. GetCharWidth, GetFontMetnc. 
GetKemPairs GetDevFontUst. AddFontAtom. GetGlyphBoundRect. GetGlyphOutline. GetPlxel, GetPixelArray. Set- 
Font SetTextColor SetLineColor. SetFillColor, SetRasterOp, CopyArea. CopyBlts. Invert, InvertPolygon. InvertTrack- 
ing InvertTrackingPolygon, DrawPixel. DrawColoredPixel. DrawPixelArray, DrawLine. DrawRect, DrawPolyLine. 
DrawPolygon DrawPolyPolygon. DrawEllipse, DrawArc, DrawPie, DrawCord. DrawGradient. DrawPolyPolyG radiant. 
DrawPolyPolyHatch, DrawText, DrawTextArray. DrawWaveLine. DrawGrid. DrawPolyPolyTransparent, and 
Draw2ColorFrame. 
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TABLE 8.: Interface XBmOutputDevice 



interface XBmOutputDevice : 

com: :sun: :star: :uno: -.Xlnterface 

{ 

unsigned long QuerySvOutputDevicePtr ( ) ; 
[oneway] void SetClipRegion ( [in] ByteSequence aData 
) ; 

[oneway] void ResetClipRegion () ; 

void GetResolution( [out] long nDPIX, [out] long 

nDPIY, [out] unsigned short nBitCount ) ; 
sequence< long > GetCharWidth ( [in] unsigned short 

nStart, [in] unsigned short nEnd ) ; 
void GetFontMetric([out] IDLFontMetricData • 

rFontMetric, [in] unsigned short nFirstChar, [in] 

unsigned short nLastCar, [in] boolean 

bGetKernPairs ) ; 
sequence< KernPair > GetKernPairs ( ) ; 
void GetDevFontList ( [out] sequence< string > 

FontNameAtoms, [out] sequence< string > 

StyleNameAtoms, [out] IDLFontDataSequence 

rFontData ) ; 

[oneway] void AddFontAtom( [in] byte Type, [in] string 

Name, [in] unsigned short Atom ); 
boolean GetGlyphBoundRect ( [in] unsigned short cChar, 
[out] long nX, [out] long nY, [out] long nWidth, 
[out] long nHeight, [in] boolean bOptiraize ) ; 
boolean GetGlyphOutline ( [in] unsigned short cChar, 
[out] ByteSequence rPoly, [in] boolean bOptimize 
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); 

void GetPixeK [in] long nX, [in] long nY, [out] 

unsigned long nColor ) ; 
void GetPixelArray{ [in] ByteSequence aData, [out] 

ULongSequence aColors ) ; 
[oneway] void SetFont ( [in] IDLFont aFont ); 
(oneway] void SetTextColor ( [in] unsigned long nColor 
) ; 

[oneway] void SetLineColor ( [in] unsigned long nColor 
) ; 

[oneway] void SetFillColor ( [in] unsigned long nColor- 
) ; 

[oneway] void SetRasterOp( [in] unsigned short nROP ); 
[oneway] void CopyArea ( [in] long nSrcX, [in] long 
nSrcY, [in] long nSrcWidth, [in] long 
nSrcHeight, [in] long nDestX, [in] long nDestY, 
tin] unsigned short nFlags ); 
[oneway] void CopyBits { [in] long nSrcX, [in] long 

nSrcY, [in] long nSrcWidth, [in] long nSrcHeight, 
[in] long nDestX, [in] long. nDestY, [in] long 
nDestWidth, [in] long nDestHeight, [in] 
XRmOutputDevice xFrom ) ; 
[oneway] void Invert ( [in] long nX, [in] long nY, [in] 
long nWidth, [in] long nHeight, [in] unsigned 
short nFlags ) ; 
[oneway] void InvertPolygon ( [in] ByteSequence 

aPolygon, [in] unsigned short nFlags ); 
[oneway] void InvertTracking { [in] long nX, [in] long 
nY, [in] long nWidth, [in] long nHeight, [inO 
unsigned short nFlags ); 
[oneway] void InvertTraclcingPolygon ( [in] ByteSequence 

aPolygon, [in] unsigned short nFlags ) ; 
[oneway] "void "brawPixeI("[i'n]- long nX", -[-inl long nY-h; 
[oneway] void DrawColoredPixel { [in] long nX, .[in] 

long nY, [in] unsigned long nColor ) ; 
[oneway] void DrawPixelArray ( [in] ByteSequence aData, 
[in] ULongSequence aColors ); 
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[oneway] void DrawLine{ [in] long nStartX, [in] long 
nStartY, [in] long nEndX, [in] long nEndY ) ; 

[oneway] void DrawRect ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight ); 

[oneway] void DrawPolyLine { [in] ByteSequence aData ); 

[oneway] void DrawPolygon( [in] ByteSequence aData ); 

[oneway] void DrawPolyPolygon ( [in] ByteSequence aData 
) ; 

[oneway] void DrawRoundedRect ( [in] long nX, [in] long 
nY, [in] long nWidth, [in] long nHeight, [in] 
unsigned long nHorzRound, [in] unsigned' long 
nVertRound ) ; 

[oneway] void DrawEllipse{ [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight ); 

[oneway] void DrawArc ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 

[oneway] void DrawPie( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 

[oneway] void DrawChord{ [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nStartX, [in] long nStartY, [in] long nEndX, [in] 
long nEndY ) ; 

[oneway] void DrawGradient ( [in] long nX, [in] long 

nY, [in] long nWidth, [in] long nHeight, [in] 

ByteSequence aData ) ; - 
[oneway] - void DrawPolyPolyGradient { [in] ByteSequence 

aPolyPolyData, [in] ByteSequence aGradientData ); 
[oneway] void DrawPolyPolyHatch ( [in] ByteSequence 

aPdlyPolyData, [in] ByteSequence aHatchData ); 
[oneway] void DrawText ( [in] long nX, [in] long nY, 

[in] string aText ) ; 
[oneway] void DrawTextArray ( [in] long nX, [in] long 

nY, [in] string aText, [in] LongSequence aLongs ) 
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[oneway] void DrawWaveLine ( [in] long nStartX, [in] 
long nStartY, [in] long nEndX, [in] long nEndY, 
[in] unsigned short nStyle ); 

[oneway] void DrawGrid( [in] long nMinX, [in] long 
nMaxX, [in] sequence< long > aHorzValues, [in] 
long nMinY, [in] long nMaxY, [in] sequence< long 
> aVertValues, [in] unsigned long nFlags ); 

[oneway] void DrawPolyPolyTransparent { [in] 
ByteSequence aData, [in] unsigned short 
nTransparencyPercent ) ; 

[oneway] void Draw2ColorFrame { [in] long x, [in] long 
y, [in] unsigned long width, [in] unsigned long 
height, [in] unsigned long lef tAndTopColor, [in] 
unsigned long rightAndBottomColor ) ; 

}; 



[01 31 ] In one embodiment, method GetFontMetric (Table 8) gets the general metrics of the current font. If the value 
of Inputs nFlrstChar and nLastChar are not equal, member maCharWidths of output structure IDLFontMetrlcData (Table 
9) is filled as it would be in a call by method GetChaiWidth and so saves one synchronous call. If the Boolean input 
value of variable bGetKemPairs is true, member maKemingPairs of output structure IDLFontMetrlcData is filled as it 
would be in a call to method GetKemPairs. and this saves another synchronous call. 

[01 32] In method AddFontAtom, Type is a FontAtomType; Name is the new atom string: and Atom the new atomic 

value 

[01 33] In Table 9, a brief description of given of the values in the various structures. 
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TABLE 9. Structure and Other Information Used by 
Interface XRmOutputDevlce 



// [in) Eingabe-Parameter. Der "Server" auf dem das 
Object liegt // ist der Remote-Client. 
// Also "Server" eigentlich "Display" 

// [oneway] => Kein warten auf Antwort 

struct KernPair 
{ 

unsigned short 
unsigned short 
short 

In- 
struct IDLFontMetricData 
{ 

// these data must be set 

// Durchschnittsbreite vom Font in Pixeln {must same as 
by Set Font) 

short mnWidth; 
// Ascent 

short mnAscent; 
// Descent 

short mnDescent; 

// Internal-Leading 

short . mnLeading; 

// Schraegstellung (bei Italic) 

short mnSlant; 

// Erstes. druckbare Zeichen im Font 

unsigned short mnFirstChar; 

// Letztes druckbare Zeichen im Font 

unsigned short mnLastChar; 

// this data should be overwritten 

// Fontname: Atom 



Charl; 
Char2 ; 
Kerning; 
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unsigned short mnName; 
// Stylename: Atom 
unsigned short mnStyleName; 
// Rotation 

short mnOrientation; 
// Family vom Font 
byte meFamily; 
// CharSet vom Font 
byte meCharSet; 
// Weight vom Font 
byte meWeight; 
// Italic vom Font 
byte meltalic; 
// Pitch vom Font 
byte " mePitch; 

// Type vom Font 
byte meType; 
// 1st es ein Device-Font 
boolean mbDevice; 
// factor for charwidths 
long mnFactor; 
sequence< long > maCharWidths; 
sequence< KernPair > maKerningPairs; 
In- 
struct IDLFontData 
{ 

// Struktur zum Abfragen der DevFontList 

// Name vom Font: Atom 

unsigned short mnName; 

// StyleName vom Font; Atom 

unsigned short mnStyleName;' 

// Breite vom Font in Pixeln 

short mnWidth; 

// Heoehe vom Font in Pixeln 

short mnHeight; 

// Family vom Font 
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byte meFamily; 
// Char Set vom Font 
byte meCharSet; 
// Pitch vom Font 
byte mePitch; 
// WidthType vom Font 
byte meWidthType; 
// Weight vom Font 
byte 

// Italic vom Font 
byte 

// Type vom Font 
byte 

// bitO: mborientation 
//bit 1: mbDevice 
byte mnBools; 



meWeight; 



meltalic; 



meType; 



struct IDLFont 

{. 

// Struktur zum 

unsigned short 

unsigned short 

short 

short 

byte 

byte 

byte 

byte 

byte 

byte 

short 

); 



Setzen eines Fonts. 
mnName; 
mnStyleName; 
mnWidth; 
mnHeight ; 
meFamily; 
meCharSet; 
meWidthType; 
meWeight; 
meltalic; 
mePitch; 
mnOrientation; 



typedef sequence< byte, 1 > ByteSequence; 
typedef sequence< long, 1 > LongSequence; 
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typedef sequence< unsigned long, 1 > ULongSequence; 
typedef sequence< unsigned short , 1 > UShortSequence; 
typedef sequence< IDLFontData, 1 > IDLFontDataSequence; 

constants FontAtomType 
{ 

const byte NAME = 0; 
const byte STYLE = 1; 

}; 



r01341 In Figure 6. class Clientfactory \nc\u6es interface XMultilnstanceFactory {rab\e 10 and Fig. 7). Class Client- 
Factory is called by an object BeanFrame to generate multiple instances of class RmFrameWindow. Interface XMuIti- 
/nstenceFactory Inherits from interface Xlnterface (Table 2). 

TABLE 10.: INTERFACE XMultilnstanceFactory 



interface XMultilnstanceFactory : 

com: :sun: :star: :uno: : Xlnterface 



{ 



sequence<any> createlnstances ( 
[in] string aObjectName/ 
[in] long nCount) ; 



[0135] In Figure 6. class Serv/ceFacfory include interface XMu/tfServ/ceFacto/y (Table 11 and Fig. 7). Class Serv- 
iceFactory is called by an object connector to generate objects LoginService and BeanService. 
-[0136]-lnterface-XMutf/SerWceFactoo^inherits-fr^ throws an exception E xc_eption_ 

(Table 12). 
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TABLE 11.: INTERFACE XMultiServiceFactory 



interface XMultiServiceFactory: 

com: :sun: :star: :uno: :XInterface 

{ 

com: : sun: :star: :uno: rXInterface createlnstance ( [in] 
string aServiceSpecif ier ) 
raises! com: : sun: : star :: uno: : Exception ); 
com: : sun: rstar: :uno: iXInterface 

createlnstanceWithArguments { 

[in] string ServiceSpecif ier r 
[in] sequence<any> Arguments ) 
raises ( com: : sun: : star; : uno: : Exception ); 
sequence<string> getAvailableServiceNames ( ) ; 
); 



[01 37] The service factory objects support this interface for creating components by a specifying string, i.e. the service 
name. In the embodiment of Table 11. interface XMultiServiceFackory includes methods createlnstance. createln- 
stanceWithArguments. and getAvailableServiceNames. 

[0138] Method createlnstance creates an instance of a component which supports the services specified by the 
factory. Input parameter ServiceSpecifler is a service name that specifies the service that should be created by this 
factory. 

[01 39] Method createlnstanceWithArguments creates an instance of a component which supports the services spec- 
ified by the factory. Input parameter aArguments Is the values of the arguments that depend on the service specification 
of the factory. Normally the factory delegates the arguments to the method init() of the created instance. The factory 
is explicitly allowed to modify, delete or add arguments. The conversion rules of the arguments are specified by a 
convener service. Input parameter ServiceSpecifler is a service name that specifies the sen^ice that should be created 

by this factory. ... . * * ^ 

[01 40] Method getAvailableServiceNames returns a sequence of all service identifiers, which can be instantiated. 
[0141] Table 12 presents one embodiment of exception Exception that is used by interface XMultiServiceFactory. 
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TABLE 12.: EXCEPTION Exception 



exception Exception 
1 

string Message; 

com: :sun: :star: :uno: :XInterface Context; 
}; 



In this embodiment, exception Exception is the basic exception from which all other exceptions are derived. Parameter 
Message specifies a detailed message of the exception or an empty string if the callee does not descnbe the exception 
Context is an object that describes the reason for the exception. Object Context may be NULL if the callee does not 

describe the exception. . . ^ ■ . ^ ■ 

[01421 Service LoginService that Is Instantiated by object ServlceFactory of the daemon includes an interface XLogm 
(Table 13 and Fig. 7). Interface XLogIn inherits from interface Xlntertece and uses an enumeration ResultofLogin. 
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TABLE 13.: INTERFACE XLogin 



enum ResultofLogin 
{ 

OK, 

NO^LICENSE, 

ALREADy_LOGGED_IN , 

SECURITY_VIOLATION, 

COULD_NOT_TO_FILESERVER, 

NO_CONFIGURATION, 

UNKNOWN_ERROR 

}; 

interface XLogin: com: :sun: :star; :uno: :XInterface 
{ 

Boolean installationHasBeenCompleted ( [in] string 

sNarneOf User ) ; 
void completelnstallation ( [in] string sNameOf User, 

[in] string sPassword ); 
ResultofLogin login ( [in] string . sNameOf User, [in] 

string sPassword, [in] string sNameOfWorkstation, 

[in] string sParameter ); 
string getQualif iedNameOf User ( [in] string 

sNameOf User ) ; 

1; 



[0143] In the embodiment of Table 13. interface XLogin includes methods installationHasBeenCompleted, com- 
pletelnstallation. login, and getQuallfiedNameOfUser. 

[01 441 Class BeanService includes an interface XRmStarOffice in the embodiment of Figure 6. One embodiment of 
interface XRmStarOffice \s presented in Table 14. Interface XflmSfa/Office inherits from interface X/nfe/faceand uses 
interfaces XMultiServiceFactDry iJab\e 11) and XRmFrameWindow ijab\e 1), See Figure 7. 
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TABLE 14. : INTERFACE XRmStarOf f ice 



typedef enum _StartUpError { 

SOFFICE_NO_ERROR, 

SOFFICE_WRONG_LOGIN , 

SOFFICE_SERVICE_NOT_FOUND, 

SOFFICE_CONNECTION_REFUSED, 

SOFFICE^NO^LICENSE, 

SOFFI CE_UNKNOWN_ERROR , 

SOFFICE_ALREADY_STARTED 
} StartUpError; 

constants StarOf f iceServerType 

( 

const long APPSERVER = 0; 
const long BEANSERVER = 1; 
const long ONESERVER = 2; 

}; 

interface XRmStarOf f ice : 

com: :sun: :star: :uno: :XInterface 

{ 

/** AppName+Params+Version+Language, weil ueber dei 
Demon dann spaeter auch andere Programme gestartet 
werden koennen. - . 
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StartUpError Start ( 

[in] com: :sun: :star: : lang: :XMultiServiceFactory 

xClientFactory, 
[in] string aConnectionName, 
[in] string aUserName, 
[in] string aPassword, 
[in] string aFileServer, 
[in] string aClientSysteitiName/ 
[in] string aAppName, 
[in] string aAppParams, 
[in] unsigned long nAppLanguage,. 
[in] unsigned long nRemoteVersion, 
[in] long servertype 

) ; 

[oneway] void SetUserInf oForPrinting ( 
[in] string AuserName, 
[in] string aPassword ) ; 
void AddRemotePrinter { 

[in] string aName, 

[in] string aServer, 

[in] boolean bSetAsDef ault, 

[in] boolean bIsLocal ) ; 
com: : sun : : star : : uno : :XInterf ace CreateBeanWindow ( 

[in] XRmFrameWindow xFrameWin, 

[in] com: : sun: : star :: lang: :XMultiServiceFactory 

xClientFactory, 
[in] any aSysteraWindowToken ) ; 

}; 



[0145] In the embodiment of Table 14, Interface XRmStarOffice includes methods Start, SetUserlnfoForPrinting, 
AddRemotePrinter, and CreateBeanWindow. Method start receives as input a reference to object ClientFactory, a user 
name, a password, identification of a file server, and a specification of the application that is to be started, e.g.. param- 
eters application name, application parameters, application language, and version. Method CreateBeanWindow re- 
ceives a reference to object RmFrameWindow, and object ClientFactory as inputs. 

[01 46] Class BeanFrame (Fig. 6) includes two Interfaces, interface XFrame (Table 1 5) and Interface XDispatchPro- 
WderCTable 62 and Fig. 9). In the embodiment of Table 1 5. Interface XFrame inherits from interface XCo/nponenf (Table 
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1 6) Interface XFrame uses Interfaces XWindow (Jable 1 9). XController {Tab\e 53 and Fig. 8C). and XFrameActionLiS' 
fener(Table59and Fig. 8C).AsllIustrated in Figures 8Ato8C. each oftheselnterfacesusesother 

exceptions, and enumerations that are described more completely below. 

[01471 intheembodimentofTablelSJnterfaceXFrameincludesmethodsinitlalize.setCreator.getCre^^^^^^ 
setName. findFrame. isTop, activate, deactivate. setComponent. getComponentWIndow, getController. contextCh- 
anged. addFrameActionUstener, and removeFrame Action Listener 



TABLE 15.: INTERFACE XFRAME 



10 



IS 



20 



interface XFrame: com: : sun: : star: :lang: :XComponent 
{ 

void initialize( [in] com: : sun: : star: :awt: :XWinclow 
xWindow ) ; 

com : : sun : : star : : awt : : XWindow getContainerWindow ( ) ; 
[oneway] void setCreator{ 
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[in] XFramesSupplier xCreator ); 

const] XFramesSupplier getCreator ( ) ; 

[const] string getNameO; 

[oneway] void setName ( [in] string aName ); 

com: : sun: :star: -.frame: :KFrame f indFrame ( [in] string 
aTargetFrameName, [in] long nSearchFlags ); 

boolean isTop () ; 
[oneway] void activate (); 

[oneway] void deactivate () ; 
boolean isActive ( ) ; 

boolean setComponent ( [in] com: : sun: : star: :awt: zXWindow 
xComponentWindoWr [in] 

com::sun::star::frame::XController xController ); 
[const] com: : sun: : star: :awt: :XWindow 

getComponentWindow ( ) ; 
[const] XController getController ( ) ; 
void contextChangedO ; 
[oneway] void addFrameActionListener ( 

[in]XFrameActionListener xListener ) ; 
[oneway] void removeFrameActionListener ( [in] 

XFrameActionListener xListener ) ; 

}; 



[01 48] Interface XFrame makes it possible to control a frame. Method initialize Is called to initalize the frame withm 
awindow MethodgetContainerWindowprovidesaccess to the window ofthe frame. Nomiallythis IS used a^^^^ 
window of the controller window. Method setCreator sets the frame container that created this frame. Only the creator 
is allowed to call method setCreator. Method getCreator returns the frame container that created this frame. Method 



36 



EP 1 130 510 A2 

getName returns the programmatic name of this frame. Method setName sets the name of the frame. Nomially, the 

mTA^ MetSl'Sr^^Sr^^^^ for a frame with the specified name. Frames may cont^n other frames e.g.. a 
f^Zsetarmaybe contained in otherframes. This hierarchy 

are taken into account I.e. self", "_top". ■_active- etc., flag nSearchFlags is ignored when companng these names 
^rp^a^^eraS^^^^ and further steps are controlled by flag nSearchFlags If allowed the name of 

SimSltself is compared with the desired one, then (again, if allowed )the method is called for all children of the fra-^e. 
Rnally the method may be called for the parent frame (if allowed). If no frame with the given name is found, a new top 
Se is crea?ed if this is not suppressed by a special value of flag FrameSearchFlag. The new frame also gets the 

?0 itof "Sod isTop detemiines If the frame is a top frame. In general, a top frame Is the frame wNch is a dire^ 
child of a task frame or which does not have a parent. If a frame returns for this method, all calls have to stop the 
search at such a frame unless the flag FrameSearchFlag::TASKS IS set. Miw» 
[0151] Method activate activates this frame and thus the component within. At first, the frame sets itself as the ac ive 
tame of its creator by calling FrameAction::FRAME_ACTIVATED. The component within this frame may listen to this 
^enttograb the focus on elation. Forsimplecomponents,thiscan be donebyaFrame^^^^^^ 
mavarab the focus to one of its windows or forward the activation to a sub-frame. ^ . ^ ^ 

[01 521 Method deactivate is called by the creator frame when another sub-frame Is activated. At first the frame de- 
activates its active sub-frame. H any. and then broadcasts a Frame Action Event with FrameAction:: 

SlM]^"MettS'Se det^ if the frame is active. Method setComponent sets a new component into the 
frame Method getComponentWindow returns the current visible component in this frame. The frame is the owner of 
the window Mettiod getController returns the current controller within this frame. Normally, it is set by a frame loader. 
[0154] Method contextChanged notifies the frame that the context of the controller 

he selection). According to a call to this interface, the frame calls with FrameActon::CONTEXT_CHANGED to all 
listeners, which are registered using this frame. For extemal controllers, this event can be used to requery dispatches^ 
roi551 Method addFrameActionListener registers an event listener, which is called when certain things happen to 
L components within this frame or within sub-frames of this frame. For example. It is possible to determine instanti- 
ation/destruction and activation/deactivation of components. Method removeFrameActionListener unregisters an event 

listener, which was registered with addFrameActionListener 0- 

[0156] Interface XFrame Inherits from interface XComponenf. . • !„terf=,.o 

One embodiment of interface XComponenf is presented in Table 16. Interface XComponenf inhente from interface 
Xlnteiface (Table 2) and uses interface XEvenfUsfenerthat in turn uses stmcture EventObJect See Figure 8A. 

TABLE 16.: INTERFACE ^Component 



interface XComponent: com: : sun: : star: :uno: :XInterf ace 
{ 

void dispose ( ) ; 

void addEventListener( [in] XEventListener xListener ); 



void removeEventListener ( 

[in] XEventListener aListener 



[0157] Interface XComponenf controls the lifetime of componente. Actually the real lifetime of an object is controlled 
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by references kept on interfaces of the object. There are two distinct meanings in keeping a reference to an Interface: 
first is to own the object; and second is to know the object. 

[01 58] To prevent cyclic references from resulting in failure to destroy an object, references of interfaces to the object 
are allowed only (I) by the owner, (li) if the reference is very temporary, or (lii) you are registered as an Event Listener 
at that object and cleared the reference when "disposing" is called. 

[01 59] An owner of an object calls method dispose to dispose of the object. Only the owner of the object calls method 
dispose if the object should be destroyed. All objects and components must release the references to the objects. If 
the object is a broadcaster, all listeners are removed and method XEventListener::disposing() is called on all listeners. 
[0160] Due to the importance of the concept of method XComponent::dispose(), a figurative example is provided. 
Imagine there was a hole in the floor and some people around it were holding a box (our component). Everyone who 
holds the box for a longer time than just temporarily (i.e. to put something in or get something out) has to watch a light 
bulb, which is attached to the box (listening to event XEventUstener::disposing()). Now, when the owner of the box 
switched the light on (calling method XComponenf.dispose 0). everybody holding the box had to take their hands off 
(clear the interface handles). If and only if everyone did that, did the box fall (getting deleted). However, only the owner 
is allowed to switch the light on! After method dispose is called, the instance has to throw exception Disposed Exception 
for all non-event-method calls and event-method calls have to be ignored. 
[01 61 ] The following is an example of one embodiment. 



void dispose 0 
{ 

// make a copy 

Listener [] aTmpListeners = MyListeners.cloneO ; 



// clear all listeners (against recursion) 
MyListeners . clear ( ) ; 



// call all listeners 

Event Object aEvt = new EventObject () ; 

aEvt-xSource = this; 

for( i = 0; i & It; aTmpListeners. length; i++ ) 

aTmpListeners [i] .disposing ( aEvt ); 

} 

[0162] Method addEventLlstener adds an event listener to the listener list for the object. The broadcaster fires the 
disposing method of this listener if method dispose() is called. Conversely, method removeEventListener removes an 
event listener from the listener list for the object. 

[01 63] As described above, interface XComponent uses interface XEventListener (Table 1 7.) 
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TABLE 17 . : INTERFACE XEventListener 



interface XEventListener: 

com: : sun: :star: runo: :XInterface 

{ 

void disposing ( [in] com: : sun: : star :: lang :: EventObject 
Source ) ; 

}; 



[01 64] Interface XEventUstener gable 1 7) inherits from interface Xtnterface (Table 2). Interface XEventUstener is 
a tagging interface that all event listener interfaces must extend. Method disposing is called when the broadcaster is 

about to be disposed. , ^ ^ w j- * 

All listeners and all other objects, which reference the broadcaster should release the references. One ennbodiment 
of stnjcture EventObject is presented In Table 1 8. 



TABLE 18.: Structure EventObject 



struct EventObject 
{ 

com: :sun: :star: :uno: :XInterface Source; 
}; 



[0165] Stmcture EventObject specifies the base for all event objects and Identifies the source of the event Field 
Source refers to the object that fired the event. ^ ^. . o . ,-. o a 

[01 66] As explained above, interface XWindow (Table 1 9) is used by interface XFrame (Table 1 5). See also Fig. 8A. 
in the embodiment of Ia_ble 1 9, interface XH//ndoi^lnheritslrqm interface XCojTjponenfaable 16)^a^ uses interfaces 
XWindowUstener (Table 21). XFocusListener (Table 23), XKeyUstener (Table 25), XMouseListener (Table 28), 
XMotiseMof/onL/sfener (Table 30), and XPaintListener (Jab\e 31). and structure Rectangle (Table 20). each of which 
is described herein. 
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TABLE 19 . : INTERFACE XWindow 



interface XWindow: com: : sun: : star: : lang : :XComponent 

loneway^] void setPosSize( [in] long X, [in] long Y, 
[in] long Width, [in] long Height, [in] short 
Flags ) ; 

[const] com: :sun: :star: :awt: :Rectangle getPosSizeO ; 
[oneway] void setVisible( [in] boolean Visible ); 
[oneway] void setEnable( [in] boolean Enable ); 
[oneway] void setFocus{); 
oneway] void addWindowListener ( [in] 

com: : sun : : star : : awt : : XWindowListener xListener ) ; 
oneway] void removeWindowListener { [in] 

com: :sun: : star: : awt: : XWindowListener xListener ) ; 
[oneway] void addFocusListener ( [in] 

com: :sun: :star: :awt: :XFocusListener xListener ); 

[oneway] void removeFocusListener { [in] 

com: : sun:: star:: awt ::XFocusListener xListener ); 

[oneway] void addKeyListener ( [in] 

com: : sun : : star : : awt : : XKeyListener xListener ) ; 
(oneway] void removeKeyListener ( [in] 

com:: sun:: star:: awt:: XKeyListener xListener ); 

[oneway] void addMouseListener ( [in] 

■ com: : sun:: star:: awt ::XMouseListener xListener ); 

[oneway] void removeMouseListener { [in] 

com::sun::star::awt::XMouseListener xListener ); 
[oneway] void addMouseMotionListener ( [in] 

com: :sun: :star: :awt: :XMouseMotionListener 

xListener ) ; 
[oneway] void removeMouseMotionListener ( [in] 
com: :sun: :star: :awt: :XMouseMotionListener 
xListener ) ; 
[oneway] void addPaintListener ( [in] 

com::sun::star::awt::XPaintListener xListener ); 
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[oneway] void removePaintListener ( [in] 

com: : sun: : star: :awt: rXPaintListener xListener ); 

); 



[0167] Interface XWindow (Table 1 9) specifies the basic operations for a window component. A window is a rectan- 
gular region on an output device with a position, size, and internal coordinate system. The main sense of a window is 
to receive events from the user. 

[01 68] Method setPosSIze sets the outer bounds of the window. Method getPosSize retums the outer bounds of the 
window. Method setVisible shows or hides the window depending on the parameter. Method setEnable enables or 
disables the window depending on the parameter Method setFocus sets the focus to the window. Method addWIn- 
dowUstener adds the specified component listener to receive component events from this window component. Method 
removeWindowListener removes the specified listener so it no longer receives component events from this window 
component. Method addFocusListener adds the specified focus listener to receive focus events from this window com- 
ponent. Method removeFocusListener removes the specified focus listener so it no longer receives focus events from 
this component. Method addKeyUistener adds the specified key listener to receive key events from this component. 
Method removeKey Listener removes the specified key listener so It no longer receives key events from this component. 
Method addMouseListener adds the specified mouse listener to receive mouse events from this component. Method 
removeMouseListener removes the specified mouse listener so it no longer receives mouse events from this compo- 
nent. Method addMouseMotionUstener adds the specified mouse motion listener to receive mouse motion events from 
this component. Method removeMouseMotionLlstener removes the specified mouse motion listener so it no longer 
receives mouse motion events from this component. Method addPaintUstener adds the specified paint listener to 
receive paint events from this component. Method removePaintListener removes the specified paint listener so It no 
longer receives paint events from this component. 

[0169] Structure Rectangle (Table 20) specifies a rectangular area by position and size. Field Y specifies the y- 
coordinate. Field Width specifies the width. Field Height specifies the height 

TABLE: 20.: STRUCTURE Rectangle 



struct Rectangle 




{ 




long X; 




long Y; 




long Width; 




long Height; 




}; 









[0170] An embodiment of Interface XWindowListenerfr\aX is used in the above embodiment of interface XWindow 
(Table 1 9) is presented in Table 21 . Interface XWindowListener Inherits from interface XEventListener (Table 1 7) and 
uses structure WindowEvent (Table 22,) 
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TABLE 21.: INTERFACE XWindowListener 



interface XWindowListener: 

com: :sun: :star: :lang: :XEventListener 

{ 

[oneway] void windowResized ( [in] 

com: : sun: : star: :awt: iWindowEvent e ); 

[oneway] void windowMoved( [in] 

com: : sun : : star : : awt : : WindowEvent e ) ; 
[oneway] void windowShown( [in] 

com: : sun: : star: :lang: :EventObject e ); 

[oneway] void windowHidden ( [in] 

com: :sun: :star: :lang: :EventObject e ) ; 

}; 



[0171] InterfaceXl/WnrfoivUstanermakesitpossibletoreceivewindow 

o notification purposes. Moves and resizes are handled internally by the window component, so that the GUI layout 
workf ^^^^^^^^ of whether a program registers such a listener Method w.ndowRes.zed -s '^^^^^^^^ 

r window has been resized Method windowMoved is involved when the window has been moved. Method window- 
SoltsT^^^^^^^^^^ has been shown. Method windowHidden Is invoked when the vnndow has been 

[0172] Oneembodimentofstructurel^ndow£venfusedinTable21 is presented In Table 22. 
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TABLE 22.: STRUCTURE WindowEvent 



struct WindowEvent: com: : sun: : star: :lang: : Even tObject 



long 


X; 


long 


Y; 


long 


Width; 


long 


Height; 


long 


Leftlnset; 


long 


Toplnset ; 


long 


Rightlnset ; 


long 


Bottomlnset ; 


1; 





roi731 structure Wnrfow£ventspecifiesthecompone^^levelkeyboardeventandinheritsfromstmctureEvenfOb;ecf 
(Table 1 8) Field X specifies the outer X-posltion of the window. Field Y specifies the outer Y-position of the w.ndow. 
Field Width specifies the outer (total) width of the window. Reld Height specifies the outer (total) height of the window. 
Field Leftlnset specifies the inset from the left. The inset is the distance between the outer and the inner w.ndow^n 
other words in this case it is the width of the left border. Field Toplnset specifies the inset from the top. The inset is the 
distance between the outer and the inner window, in other words in this case it is the height of the top border. Field 
Rightlnset specifies the inset from the right. The inset is the distance between the outer and the inner window, in other 
words in this case it is the width of the right border. Field Bottomlnset specifies the inset from the bottom. The inset is 
the distance between the outer and the inner window, in other words In this case it is the height of the bottom border. 
10174] An embodiment of interface XFocusListener \hsA is used in the above embodiment of interface XVWnctoiv 
Crable 19) is presented in Table 23. Interface XFbcusUsfener inherits from interface XEventUstener (JaUe 17) and 
uses structure FocusEvent (Table 24.) 



43 



EP1 130 510 A2 

TABLE 23.: INTERFACE XFocusListener 



10 



15 



20 



interface XFocusListener: 

com: rsun: rstar: :lang: :XEventListener 

{ 

[oneway] void f ocusGained ( [in] 

com: : sun: : star: :awt: :FocusEvent e ); 

[oneway] void f ocusLost ( [in] 

com : : sun : : st ar : : awt : : FocusEvent e ) ; 

}; 



r0175l Interface XFocusUstener makes it possible to receive keyboard focus events. The window, which has the 

25 SboardS 

the keyboard focus. Method focusLost Is Invoked when a window loses the keyboard focus 
[01 76] One embodiment of structure FocusEvent used in Table 23 is presented in Table 24. 



30 



TABLE 24, 



STRUCTURE FocusEvent 



35 



40 



45 



50 



55 



Struct FocusEvent: com: : sun: : star :: lang: :EventObj ect 
{ 

short FocusFlags; 

com: :sun: :star: :uno: :XInterface NextFocus; 

boolean Temporary; 

}; 



[0177] structure Foct/sEvent specifies a keyboard focus event, and inherits from structure E^enfObyecf (Tab el 8)^ 
?he\?are ro eve^^ 

rcuTi« moved from one component to another, such as through calls to method ^-^^Fo-^^^^^^^^ 
uses the Tab key to traverse components. Temporary focus change events occur when focus ,s gamed or lost for a 
^om^^^^^^^^ indirect result ofanother operation, such as window deactivation or a scrollbar drag. In this case, 

he oSna "c^^^^^^^^^^ is automatically restored once that operation is finished, or for the case ot ^m^^^^^ 
when the windowisreactivated. Both permanent and temporary focus events are delivered us^^gm 

and FOCUS LOST event ids; the levels may be distinguished in the event using the '^7^°^^^^^^^^ 

?01781 Fiefd FocusFlags specifies the reason for the focus change as an arithmetic, or combinabon of FocusChang- 
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If this focus change event is a temporary change. 

[0179] An embodiment of interface XKeyUstenerthaX is used in the above embodiment of interface XWindow (Table 
1 9) is presented in Table 25. Interface XKeyL/sfener inherits from Interface XEventListener (Jab\e 1 7) and uses structure 
KeyEvent (Table 24.) that in turn inherits from structure InputEvent (Table 27). 

TABLE 25.: INTERFACE XKeyListener 



interface XKeyListener: 

com: : sun: : star: :lang: : XEventListener 

{ 

[oneway] void keyPressed( [in] 

com: : sun: : star : :awt: : KeyEvent e ); 

[oneway] void IceyReleased ( [in] 

com: : sun: : star: :awt; : KeyEvent e ); 

}; 



[0180] Interface XKeyListener ma\<ies it possible to receive keyboard events. Method keyPressed Is Invoked when 
a key has been pressed. Method keyReleased is invoked when a key has been released. 

[0181] The embodiment of structure KeyEvent\n Table 26 inherits from structure InputEvent (Jable 27), as described 
above. Stmcture KeyEvent speafies the component-level keyboard event. Field KeyCode contains the Integer code 
representing the key of the event. 

This is a constant from the constant group Key. Field KeyChar contains the Unicode character generated by this event 
or 0. Field Key Func contains the function type of the key event This is a constant from the constant group KeyFunction. 



TABLE 26.: STRUCTURE KeyEvent 



struct KeyEvent: com: rsun: :star: :awt: : InputEvent 

{ 

short KeyCode; 
char KeyChar; 
short Key Func; 



[0182] Structure InputEvent is the root event class for all component-level input events and inherits from structure 
EvenfO/?yecf (Table 1 8). Input events are delivered to listeners before they are processed normally by the source where 
they originated. Stmcture /npufEi^enf contains the modifier keys, which were pressed while the event occun-ed, I.e., 
zero or more constants from the KeyModifler group. 



45 



EP1 130 510A2 



TABLE 27.: STRUCTURE InputEvent 



10 



15 



Struct InputEvent: com: : sun: : star :: lang :: EventObj ect 



short Modifiers; 
}; 



[01831 An embodiment of interface XMouseListenenUaX is used in the ^^^^^^^^^^^ 
(Table 19) is presented in Table 28. Interface XMouseL/stener .nhents from '"^^^^^^^^^^^ 
uses structure MouseEvent (Table 29.) that in turn inherits from stmcture InputEvent (Table 27). 



TABLE 28.: INTERFACE XMouseLis tener 



25 



30 
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45 



SO 



55 



[oneway] void mousePressed ( [in] 

com: : sun: : star: :awt: :MouseEvent e ); 

[oneway] void mouseReleased ( [in] 

com: : sun: : star: :awt: :MouseEvent e ); 

[oneway] void mouseEntered { [in] 

com: : sun: : star: :awt: :Mou5eEvent e ); 

[oneway] void mouseExited{ [in] 

com: :sun: :star: :awt: :MouseEvent e ); 

}; 
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TABLE 29.: STRUCTURE MouseEvent 



struct MouseEvent : com: : sun :: star : : awt : : InputEvent 



{ 



short Buttons; 



long X; 
long Y; 

long ClickCount; 
boolean PopupTrigger ; 

}; 



101861 structure MouseE>^en( specifies an event from the mouse. Field Buttons contains the pressed mouse iDUttons, 
which are zero or more constants from the group MouseButton. Field X contains the x coordinate location of the mouse. 
Field Y contains the y coordinate location of the mouse. Field ClickCount contains the number of mouse clicks asso- 
ciated with evert. Field PopupTrigger specifies if this event is a popup-menu trigger event. 

r01 87] An embodimert of Interface XMouseMotfonL/sfenerthat is used in the above embodimert of interface XWin- 
dow rrable 1 9) is presented in Table 30. Interface XMouseMof/o/i/./stenerinherits from Interface xevenf/.fe(ener(Table 
17) and uses structure MouseEvent (Table 29). 



TABLE 30.: INTERFACE XMouseMotionListener 



interface XMouseMotionListener: 

com: : sun: :star: :lang: :XEventListener 

{ 

void mouseDragged( [in] com: : sun: : star: : awt :: MouseEvent 
e ); 

void mouseMoved( [in] com: : sun: : star :: awt :: MouseEvent e 
}; 



[01881 Interface XMouseMotionUstener makes it possible to receive mouse motion events on a window. Method 
mouseDragged Is Invoked when a mouse button is pressed on a window and then dragged. Mouse drag events continue 
to be delivered to the window where the first evert originated until the mouse button is released independent of whetiner 
the mouse position is within the bounds of the window. Method MouseMoved is Invoked when the mouse button has 



47 



11 _1 



EP 1 130 510 A2 



Z PaSnf (Table 32) that inherits from structure EvenfOi^ecf (Table 18) and structure Rectangle (Table 20). See 
Figure 8B. 



TABLE 31.: INTERFACE XPaintListener 

10 



15 



20 



interface XPaintListener: 

com : : sun : : star : : lang : : XEventList ener 

I 

[oneway] void windowPaint ( [in] 

com: :sun: :star: :awt: rPaintEvent e ); 

); 



25 



[0190] interface XPaintListener makes It possible to receive paint events. Method WindowPaint is called when a 
region of the window becomes invalid, for example, because another window was moved away. 



30 



TABLE 32.: STRUCTURE PaintEvent 
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Struct PaintEvent: com: : sun: : star: : lang: :EventObject 
{ 

com: : sun : : star : : awt : : Rectangle UpdateRect ; 

short Count; 

}; 



roi91] structure Pa/nJ£venf specifies the paint event for a component. Tt,ls event is a special type, which .s used o 

ensure thSt/update method calls are serialized along with the other events delivered from the event queueJ.eW 

uiateR^t'contaiSs the rectangle area, which needs to be repainted^^^^^^ 

that follows this event if it is a multiple PaintEvent. Paint events can be collected until Count is zero. 

Tofs? " *mSment of Interfac'e XF;..esS.pp//er that is used in the above -bodime„t o, 

fTable 19) is presented In Table 33. Interlace XFramesSupp//er inherits from interface XFrame (Table 15) and uses 

SrfLe xSes 2 in turn inherits from seve^ 

ies enumSions. and excepBons. One embodiment of each of these Interfaces, structures, enumeraton. and ex- 
ceptions are described herein. 
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TABLE 33.: INTERFACE XFrames Supplier 



10 



interface XFramesSupplier : XFrame 



20 



25 



30 
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XFrames get Frames ( ) ; 
[const] XFrame getActiveFrame ( ) ; 
void setActiveFrame ( [in] XFrame xFrame ) 



[0193] Method getFrames returns the collection of (sub-) frames, which is represented by a contamer FramesCon- 
ainer Method getActiveFrame returns the sub-frame. which is active within this frame. This may be the frame .tself. 
The active frame is defined as the frame, which contains (recursively) the window with the focus. If no window w.thin 
the frame contains the focus, this method returns the last frame, which had the focus, if no containing window ever 
had the focus, the first frame within this frame is returned. K^^.n^Honiw 
[0194] Method setActive Frame is called on activation of a direct sub-frame. This method is allowed to be ca'^d only 
by a sub-frame. After this call, the frame specified by input parameter xFrame is returned. In general this method firs 
calls the method at the creator frame with this as the current argument. Then It broadcasts the FrameAction Event 
FrameAction::FRAME_ACTlVATED. ^ . . ^ ^ 

roi 95] In the embodiment of Table 34. interface XFrames inherits from Interface XIndexAccess (Table 35). Interface 
XFrames manages and creates frames. Frames may contain other frames by implementing an interface XFrames and 
may be contained in other frames. 

TABLE 34.: INTERFACE XFrames 
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interface XFrames: 

com: : sun : : star : : container : : XIndexAccess 

{ 

void append ( 

[in], com: : sun jj star: : frame :: XFrame xFrame ); 
sequence<com: : sun: : star: : frame: :XFrame> quer'yFrames ( 

[in] long nSearchFlags ); 
void remove ( [in] com: : sun: : star :: frame: : XFrame xFrame 



); 



}; 



49 



EP 1 130 510 A2 

[0196] Method append appends the specified Frame to a list of sub-frames. Method queryFrames returns ail child 
frames of the container, which are intended to be visible to other objects. The content of the sequence may be limited 
by the caller through the flag FrameSearchFlag. 

[0197] Method remove removes the frame from Its container. The creator attribute of the frame must be reset by the 

5 caller of this method. 

[01 98] The embodiment of interface XIndexAccess in Table 35 provides access to the elements of a collection through 
an index. This interface should only be used if the data structure Itself is indexed. 

10 TABLE 35.: INTERFACE XIndexAccess 



interface XIndexAccess: 

com: :sun: :star: icontainer: ; XElementAccess 

20 

{ 

[const] long getCountO; 

[const] any getByIndex( [in] long Index ) 
raises ( 

com: :sun: :star: :lang: : IndexOutOf BoundsException^ 
com: :sun: :star: :lang: : WrappedTargetException ) ; 

}; 



35 [0199] Method getCount returns the number of elements. Method getBylndex returns the element at the specified 
index. Parameter Index specifies the position in the array. 

The first index is 0. Method getBylndex throws com::sun::star::lang::lndexOutOfBoundsException (Table 52) if the 
index is not valid. Method getBylndex throws com::sun::star::lang::WrappedTargetException (Table 49), if the imple- 
mentation has internal reasons for exceptions that are wrapped in exception WrappedTargetException. 
40 [0200] In this embodiment, interface XElementAccess is the base interface of all collection interfaces. 
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TABLE 36.: INTERFACE XElementAccess 



10 



15 



interface XElementAccess: 

com : : sun : : star : : uno : : XInterf ace 

{ 

[const] TYPE_XIDLCLASS getElementType ( ) 
[const] boolean hasElements ( ) ; 



20 
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30 



[0201] Interface XElementAccess inherits from Interface XInterface (Table 2). Method getElementType returns the 
type of the elements. Void means that the container Is a multi-type container and the exact types with this interface 
cannot be determined with this method. Method hasElements returns <TRUE> If the object contain elements, otherwise 

One embodiment of interface XldlClass Is presented in Table 37. Interface XldlClass provides Information 
about a type or module. Every array also belongs to a type that is reflected as an XldlClass object that is shared by 
all arrays with the same element type and number of dimensions. Finally, any of the primitive IDL types are also rep- 
resented as XldlClass objects. This includes "void, any, boolean, char, float, double, octet, short, long, hyper, unsigned 
octet, unsigned short, unsigned long" and "unsigned hyper". Interface XW/C/ass inherits from interface XInterface (Table 
2) 
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TABLE 37.: INTERFACE XldlClass 



interface XldlClass: com: :sun: :star: :uno: :XInterface 
{ 

sequence<XIdlClass> getClassesO; 

XldlClass getClass( [in] string aName ); 

boolean equals { [in] XldlClass Type ); 

boolean isAssignableFrom( [in] XldlClass xType ); 

com: : sun: : star: :uno: :TypeClass getTypeClass ( ) ; 

string getName () ; 

[const] com: : sun: : star: :uno: :Uik getUikO; 
sequence<XIdlClass> getSuperclasses ( ) / 
sequence<XIdlClass> getlnterf aces ( ) ; 
XldlClass getComponentType 0 ; 
XldlField getField( [in] string aName ); 
sequence<XIdlField> getFieldsO ; 
XldlMethod getMethod( [in] string aName ); 



sequence<XIdlMethod> getMethods ( ) ; 

XldlArray getArrayO; 

void createObject { [out] any obj ); 

}; 



[0203] Method getClasses returns all types and modules, which are declared in this class. Method getClass returns 
a type or module with the given name that is declared in this class. Method equals returns <TRUE> if the instances 
describe the same type, otherwise <FALSE>. Method isAssignableFrom tests if the parameter xType is a subclass of 
this class. Method getTypeClass returns the type that this instance represents. Method getName returns the fully qual- 
ified name of the type of object (class, interface, array, sequence, struct, union, enum or primitive) represented by this 
XldlClass object. Method getUik returns the UIK from this type. If the type has no UIK. the retumed UIK is zero. 
[0204] If this object represents an interface or a class, the objects that represent the superclasses or supennterfaces 
of that class are retumed by method getSuperclasses. If this object is the one that represents the topmost class or 
interface, an empty sequence is retumed. ^ -j u *u- 

[0205] Method getlnterfaces determines the interfaces implemented by the class or interface represented by this 
object If the class or interface implements no interfaces, the method retums a sequence of length 0. 
10206] If this class represents an array or sequence type, method GetComponentType returns the XldlClass object 
representing the component type of the array or sequence; otherwise it retums null. Method getField retums an XldlReld 
object that reflects the specified member field of the class, interface, struct, union, enum or exception represented by 
this XldlClass object If a field with the specified name is not found, 0 is retumed. The field to be reflected is located 
by searching all the member fields of the class, interface, struct, union, enum or exception represented by this XldlClass 
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10 



15 



20 



object for a field witt, the specified name or for NULL, if a field with the specified name is not found. Parameter aName 
specifies the simple name of the desired field. k^w,. »h= ,.ioo= 

St] Method getFields returns a sequence containing Field objects reflecting all the accessible fields of the class 
nterface, stmct. union or enum represented by this XldlClass object l«lethod getFields returns a sequence of leng^ 
Oftredassorimerfacehasnoaccessiblefields,orifitrepresentsanarray.asequenceorapn^^^^^^^^ 
if this XldlClass object represents a class, this method returns the fields of this class and of all its superclasses Jf this 
X dICIass object represents an interface, the method returns the fields of this interface and of all its supennterfaces. 
If this XldlClass object represents an array, sequence or primitive type, this method returns a sequence of length 0. 
[0208] Method getMethod returns an XldlMethod object that reflects the specified member method of the interface 
represented by this XldlClass object. If a method with the specified name is not found, "0" is 
be reflected is located by searching ail the member methods of the interface represented by this XldlClass ob,ect for 
a method with the specified name. 

r0209] Parameter aName specifies the simple name of the desired method. ,u ^ * 

[0210 Method getMethods returns a sequence containing XldlMethod objects reflecting all the member methods of 
L class or interface represented by this XldlClass object, including those declared by the class or interface and those 
inherited from superclassesand supennterfaces. ReturnsasequenceoflengthOiftheclassorinterfaceh^ 

ST Method getArray returns interface XldlArmy (Table 50) to get and set the elements byjndex.i^;^he r^^^ 

type is an array or sequence. Method createObject creates an instance of the type represented by this XldlClass object 

if the represented type is a basic type, struct, enum. or sequence. 

[0212] Enumeration TypeCiass (Table 38) describe all type classes, which can be defined in the IDL 
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TABLE 38.: Enumeration TypeCiass 
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enum TypeCiass 
I 

VOID, 
CHAR, 
BOOLEAN , 
BYTE, 
SHORT, 

aNSIGNED_SHORT, 
LONG, 

UNSIGNED_LONG, 
HYPER, 

UNSIGNED HYPER, 



so 
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FLOAT , 

DOUBLE, 

STRING, 

TYPE; 

ANY, 

ENUM, 

TYPEDEF, 

STRUCT, 

UNION, 

ARRAY, 

INTERFACE, 

SERVICE, 

MODULE, 

INTERFACE_METHOD, 

INTERFACE_ATTRIBUTE, 

UNKNOWN 

}; 



[021 3] Interface XldlField (Table 39) inherits from interface XldlMember (Table 40). 
TABLE 39. : INTERFACE XldlField 



interface XldlField: 

com: : sun :: star: : reflection :: XldlMember 

.{ 

com: : sun: : star: : reflection: :XIdlClass getTypeO ; 
com: :sun: :star: :reflection: : FieldAccessMode 

getAccessMode ( ) ; 
any get ( [in] any obj ) 
raises ( 

com: : sun: : star: :lang: :IllegalArgumentException ) ; 
void set( [in] any obj, [in] any value ) 
raises { 

com: : sun: : star: :lang: :IllegalArgumentException, 
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com: :sun: -.star: : lang : : IllegalAccessException 



}; 



[021 4] Method getType returns an XldlClass object that identifies the declared type for the field l^'f^'^^^yj^ 
Xldlpield Object. Ithod getAccessMode returns an enumeration value, which denotes whether the field .s const . 

value Is obtained as follows: 

If the underlying field is a constant, the object argument is ignored; it may be NULL; 
OthenAfise. the underlying field is an instance field. 

r02161 If the SDeclfied object argument is NULL, the method throws an -lllegalArgumentException". If the specified 
K is oun iSSnce of heclass. interface, stmct. union or enum declaring the underlying field, the method throws 
an iLlSmenException-. Otherwise, the value is retrieved from the underiying instance or cons tanL 

JSvLue?heoperationproceedsas^ 

ZalAraumentException (Table 42). If the specified object argument is not an instance of the class or interface de- 
arinX If S^^^^^^ the method throws an exception lIlegalArgumentException. If the underiymg field is con- 
s^n! the metSd throws a^ exception IllegalAccessException (Table 43) . If the new value cannot be converted to the 
rp^orundeS field by an idenfity or widening conversion, the method throws an lIlegalArgumentException. The 

possible to access members of classes dynamically. 

TABLE 40.: INTERFACE XldlMember 



interface XldlMember: com: : sun: : star: :uno: :KInterf ace 
{ 

XldlClass getDeclaringClassO; 

string getNameO; 

); 



[0219] MethodgetDeclaringClassretumstheXldlClassobjectrepresent.ngtheclass,inerfacestmctu^^^ 
Sa declares the member represented by this member. Method getName returns the fully qualified name of the type 
Tcis Surface a^L sequence, stnict. union, enum or primitive) represented by this XldlClass object, as a stnng. 
SS TheSl^enume^^^^ 
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TABLE 41. : Enumeration FieldAccessMode 



enum FieldAccessMode 
{ 

// 

/** The property is readable and writeable 

READWRITE, 

// 

/** The property is readonly 
*/ 

READONLY, 

// 

The property is write only 

WRITEONLY, 

// 

/** ©deprecated 

*/ 
CONST 

}; 



[0221] Exception lllegalArgumentException (Table 42) Is thrown to indicate that a method has passed an illegal or 
inappropriate argument. Exception HIegalArgumentException inherits from exception Exception (Table 12). Field Ar- 
gumentPosition identifies the position of the illegal argument. This field Is -1 If the position is not known. 
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TABLE 42.: EXCEPTION IllegalArgumentException 



exception IllegalArgumentException: 
com: :sun: : star: :uno: : Exception 

{ 

short ArgumentPosition; 



[0222] Exception lllegalAccessException (Table 43) is thrown when an application tries to change a constant property. 
Exception lllegalAccessException \nher\ts from exception Exception (Table 12). 



TABLE 43.: EXCEPTION lllegalAccessException 



exception lllegalAccessException: 

com: : sun : : star : : uno : : Exception 

{ 



[0223] Interface XldlMethod (Table 44) inherits from interface X/d/Member (Table 40). Interface X/d/Member makes 
it possible to access the specification of a method dynamically. 

TABLE 4 4.: INTERFACE XldlMethod 



interface XldlMethod: 

com: rsun: :st_ar: : reflection :jXIdlMember 

{ 

XldlClass getReturnTypeO ; 
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sequence<XIdlClass> getParameterTypes ( ) ; 
sequence<ParamInfo> getParameterlnfos () ; 
sequence<com: :sun: -.star: : reflection: :XIdlClass> 

getExceptionTypes ( ) ; 
com: : sun: : star: :reflection: :MethodMode getMode () ; 
any invoke ( [in] any ob j , [inout] sequence<any> args ) 
raises ( 

com: : sun: : star: : lang: :IllegalArgumentException, 
com: : sun: : star: : reflection: : invocationTargetException 



) 



1; 



102241 Method getRetumType returns an XldlClass object that represents the formal return type of the method rep- 
Sed by tfS objS. Method getParameterTypes returns a sequence of XldlClass objects that represent 

t™:Tor?afja^rterrpes. in declaration order, of the method represented by this Method object. Method getParam- 
eterTypes returns a sequence of length 0 If the underlying method takes no parameters. 

?S Meld getpTrameterlnfos returns a sequence of Paramlnfo objects that represent alhnfonnaton about the 
E patmeter types, in declaration order, of the method represented by this Method object Metinod getParameter- 
lnfos returns a sequence of length 0 if the underlying method takes no parameters. „x.u„,h„,^„H 
O^rMihti getExceptionTypes returns a sequence of XldlClass objects that represent tiie types of the checked 
Sonstrl t^^^^^^^ method represented by this Method object Method getExceptionTypes returns a 

cipnupnce of lenath 0 if the method throws no checked exceptions. 

p^?| Method g^^^^^^ returns an enumeration value, which denotes whett^er the method ,s 

L?hod invoke invokes the underlying method represented by this mettibd object on the specfted object w.ti, tiie 

specified parameters. Individual parameters are subject Id widening conversions as necessary. 

[0228] Method invocation proceeds in the following order: 

If the specified object argument is NUU.. the invocation tiirows an lllegalArgumentException; and 

Otiierwise if the specified object argument is not an instance of tine class or interface declaring ttie underlying 

method, tiie invocation throws an exception lllegalArgumentException (Table 42). 
[02291 lfttienumberofactualparameterssuppIiedvlaargsisdifferentfromthenumberoffom,alpaia™te^^^^^ 
bvTe underlying mettiod. the invocation throws an Exception lllegalArgumentException. For each actual parameter 
Sro Jled aras amy If the parameter value cannot be converted to tine corresponding fom,al parameter type by 
i,TdeSCSnTSL^^^^ the invocation ttirows exception lllegalArgumentException. When the contro trans- 
fers toleSnSrg mettiod and the metiiod stops abruptiy by tiirowing an exception, the exception .s placed m an 
exceXnlnvSS^ 

Sly"the value it returns is returned to the caller of ttie method. If the underlying mettiod returns type .s vo.d. ttie 

invocation returns VOID. ^^.u^h 
[0230] Structure Paramlnio (Table 45) describes a fornial parameter of a method. 



58 



EP1 130 510 A2 

TABLE 4 5.: STRUCTURE Paramlnfo 



struct Paramlnfo 

( 

/** The name of the parameter, 
*/ 

string aName; 

// 

/** One of the values IN, OUT, INOUT from the ParamMode 
enumeration. 
*/ 

ParamMode aMode; 

// 

/** The type of the parameter. 
*/ 

XldlClass aType; 



} 



[0231] The values in Enumeration ParamMode (Table 46) are used to specrfy rf a formal ^-"^ of a mett^o^^^ .s 
used for input output or both. If the value Is anlN parameter, data can only transferred from the ca "ee to the caller. If 
L 3iue is an OUT parameter, data can only transferred from the caller to the callee. If value is an INOUT parameter, 
data can transferred in both directions. 
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TABLE 4 6.: ENUMERATION ParamMode 



enum ParamMode 
{ 

IN, 

OUT, 

INOUT 

}; 



[0232] The values in Enumeration MethodMode (Table 47) are used to specify the calling mode of a method. If the 
value is an ONEWAY parameter, the method call may be asynchronous. If the value is a TWOWAY parameter, the 
method call is synchronous. 

TABLE 47.: ENUMERATION MethodMode 



enum MethodMode 
{ 

ONEWAY, 
TWOWAY 

}; 



[0233] Exception InvocationTargetException (Table 48) is a checked exception that wraps another exception. Typi- 
cally such exceptions are thrown by an invoked method or constructor. Exception InvocationTargetException inherits 
from exception WrappedTargetException (Table 49). 

TABLE 48.: EXCEPTION InvocationTargetException 



exception InvocationTargetException: 

com: :sun: :star: :lang: : WrappedTargetException 

{ 

); 
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r0234] Exception WrappedTargeiBxception (Table 49) is a checked exception that wraps anexcepUon thrown by Je 
S target NoLlly L exTeplion is declared for generic methods. Exception WrappscrrargetE.ceptK>n .nhents 
from exception Exception{Tab\e 12). 



TABLE 49.: EXCEPTION WrappedTarget Except ion 



10 



20 



exception WrappedTargetExcept ion : 

com : : sun : : star : : uno : : Exception 

{ 

any TargetException; 
}; 



[0235] interface XidlArray (Table 50) provides methods to dynamically access arrays. Interface XldlArray Inherits 
25 from Interface XInterface (Table 2) . 

TABLE 50 . : INTERFACE XldlArray 



30 



35 



in 



terface XldlArray: com: : sun: : star :: uno: : XInterface 
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void realloc{ [inout] any array, [in] long length ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException ) ; 
long getLen( [in] any array ) 
raises { 

com: :sun: rstar: :lang: : IllegalArgumentException ) ; 
any get ( [in] any aArray, [in] long nindex ) 
raises ( 

com: :sun: :star: :lang: : IllegalArgumentException, 
com: : sun: : star: :lang: : Array IndexOutOfBoundsExcepti 
on ) ; 

void set( [inout] any aArray, [in] long nindex, [in] 
any aNewValue ) 
raises { 

com: :sun: rstar: :lang: : IllegalArgumentException, 
com: :sun: :star: :lang: : ArraylndexOutOf BoundsException 

) ; 

}; 



[0236] Method realloc in interface X/of/Array changes the size of the array to the new size. If the new length is greater, 
the additional elements are default constructed, othenwise the elements are destructed. Method realloc throws an 
exception IllegalArgumentException (Table 42) if the specified object is not an array or if the specified object is null. 
[0237] Method getLen in interface XldlArray returns the number of elements in the array. Method getLen throws an 
exception IllegalArgumentException (Table 42) if the specified object is not an array or if the specified object is null. 
[0238] Method get in interface XldlArray returns the value of the indexed component in the specified array object. 
Method get throws exception IllegalArgumentException, if the specified object is not an array or if the specified object 
is null. Method get throws exception ArraylndexOutOfBoundsException (Table 51), if the specified index argument is 
negative, or if the specified index argument is greater than or equal to the length of the specified an^y. 
[0239] Method set in interface XldlArray sets the value of the indexed component of the specified array object to the 
specified new value. Method set throws exception IllegalArgumentException, if the specified object is not an array or 
if the specified object is null. Method set throws exception ArraylndexOutOfBoundsException (Table 51), if the specified 
index argument is negative, or if the specified index argument is greater than or equal to the length of the specified array. 
[0240] Exception ArrayhdexOutOfBoundsException (Table 51 ) is thrown to indicate that an array has been accessed 
with an illegal index. The index is either negative or greater than or equal to the size of the array. Exception Arrayln- 
dexOutOfBoundsException inherits from exception IndexOutOfBoundsException (Table 52). 
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TABLE 51.: EXCEPTION AzraylndexOutOfBoundsExcepti 



on 



exception ArraylndexOutOf BoundsException : 

com: : sun: : star: :lang: rIndexOutOf BoundsException- 

{ 

}; 



[02411 Exception IndexOutOfBoundsException (Table 52) is thrown to indicate that a container has been accessed 
with an illegal index. The index is either negative or greater than or equal to the count of the elements. Exception 
/ndaxOutOffloundsExcepfio/i inherits from exception Exception (Table 12). 

TABLE 52.: EXCEPTION IndexOutOfBoundsException 



exception IndexOutOfBoundsException : 
com: :sun: :star: :uno: : Exception 



}; 



r02421 As explained above, interface XFrame (Table 1 5) uses interface XConfro/ter (Table 53). With interface XCon- 
tro/te/; components viewed in a frame can serve events by supplying dispatches. Interface XCOnfro/ter inhents from 
interface XCD/nponenf (Table 16). 
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TABLE 53. : INTERFACE XController 



interface XController: com: : sun: : star: : lang: iXComponent 
{ 

void attachFrame( [in] XFrame xFrame ); 
boolean attachModel ( [in] XModel xModel ); 
boolean suspend ( [in] boolean bSuspend ); 
any getViewData { ) ; 

void restoreViewData ( [in] any Data ); 
XModel getModelO ; 
XFrame getFrameO; 
}; 



[0243] Method attachFrame (Table 53) Is called to attach the controller with Its managing frame. Method attachModel 
is called to attach the controller to a new model. Method suspend is called to prepare the controller for closing the view. 
Method getViewData returns data that can be used to restore the current view status. Method restoreViewData restores 
the view status using the data gotten from a previous call. Method getMpdel returns the currently attached model. 
Method getFrame retums the frame containing this controller. 

[0244] lnTable54 interface XMode/ represents a component, which is created from an URL and arguments. Interface 
XModel is a representation of a resource in the sense that the interface was created/loaded from the resource. The 
arguments are passed to the loader to modify its behavior. An example for such an argument is -AsTemplate". which 
loads the resource as a template for a new document. Models can be controlled by controller components, which are 
usually views of the model. If there is at least one controller, there is by definition a current controller, and if that controller 
supports interface XSelectionSupplier. it has a cun^ent selection too. Interface XMode/ inherits from interface XCom- 
ponenf (Table 16). 
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TABLE 54. : INTERFACE XModel 
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interface XModel: com: : sun: : star :: lang: rXComponent 
{ 

boolean attachResource( [in] string aURL, [in] 

sequence<com: : sun: : star: : beans :: Property Value> 
aArgs ) ; 

string getURL ( ) ; 

sequence<com: :sun: : star :: beans :: PropertyValue> 

getArgs ( ) ; 
[oneway] void connectController ( [in] 

com: : sun: : star: : frame: :XControiler xController ); 
[oneway] void disconnectController ( [in] 

com: : sun: : star: : frame: : XController xController ); 
[oneway] void lockControllers ( ) ; 
[oneway] void unlockControllers ( ) ; 
boolean hasControllersLocked ( ) ; 
[const] com: :sun: :star: : frame: : XController 

getCurrentController ( ) ; 
void setCurrentController ( [in] 

com:: sun:: star:: frame: :XController xController ) 

raises ( 

com: :sun: : star :: container : :NoSuchElementExcep 
tion ) ; 

[const] com: : sun: : star: :uno: :XInterf ace 
getCurrentSelectionO ; 

}; 



[0245] Method attachResource (Table 54) informs a model about its resource description. Method getURL returns 
the URL of the resource, which is represented by this model. Method getArgs returns the arguments with which the 
model was originally created or stored the last time. Method connectController is called whenever a new controller ts 
created for this model. Interface XComponentof the controller must be used to recognize when the controllens deleted 
Method disconnectController is called whenever a new controller is created for this model. Again, interface XComponent 
of the controller must be used to recognize when the controller is deleted. ^ x ^- . 

[0246] Method lockControllers (Table 54) suspends some notifications to the controllers, which are used for display 
updates. The calls to this method may be nested and even overlapping, but the calls must be in pairs. While there is 
at least one \ock remaining, some notifications for display updates are not broadcasted. 
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[0247] Method unlockControllers (Table 54) resumes the notifications, which ^^-f ^^"SP^"!^^^^^ jj^ 1*° ""^.f ° 
lers The calls to this method may be nested and even overiapping. but they must be in pairs. While there is at least 
one locl< remaining, some notifications for display updates are not broadcasted. .,,u:,«. »horo « at 

ro248] Method hasControllersLocked (Table 54) determines if there is at least one lock remaining. Whiie there is at 
east one lock remaining, some notifications for display updates are not broadcasted to the con^o'le"^- ■ 
[0249] Method getCurrentController (Table 54) returns the controller, which currently controls this model, f the con- 
roller which is active, is a controller of this model, it will be returned, if not, the controller, which *e last actve 
c^ntriller of this model, is returned, if no controller of this model ever was active, the controller first registered .s 
returned. If no controller is registered for this model, NULL is returned. . . »»th„H cotrnr 

[0250] Method setCurrentController (Table 54) sets a registered controller as the current controller. Method setCur- 
rentController throws exception NoSuchElemenException (Table 58). if tho™ ■= no 

[0251] Method getCurrentSelection (Table 54) returns the current selection in the current controller. If there is no 
current controller, the method returns NULL. 

[0252] Structure PropertyValue (Table 55) specifies a property value. Field Name (Table 55) specifies the name of 
Se prU^ The name isTnique within a sequence of Property Values. Field Handle (Table 55) contains an implemen- 
taUon-spedfic handle for the property. The handle may be -1 if the implementation has no handle^ 
If available, the handle it can be used for fast lookups. Field value contains the value of the property o^^^^^^^ 

is available. Field State detemiines if the value comes from the object itself or from a default, and if the value cannot 
be determined exactly 

TABLE 55. : STRUCTURE PropertyValue 



struct PropertyValue 
{ 

string Name; 
long Handle; 
any Value; 

com: : sun : : star : : beans : : PropertyState State ; 



[0253] Enumeration PropertyState (Table 56) lists the states that a property value can have. ^Je """^^o' 
two aspects: whether a value is available or void; and whether the value is stored in the property set itself or is a default 

SrvSue D1RECT_VALUE (Table 56) of the property is stored in the PropertySet itself. The property value must 
be available and of the specified type, if field PropertyAttribute in structure Property enable 57) contains PropertyAt- 
tribute::MAYBEVOID, then the value may be void. n-w Dr^Lrt 

[0255] Value DEFAULT.VALUE (Table 56) of the property is available from ^/"f «^ j^'S^t^^lJ f 
vAttribute in stmcture Property (Table 57) must contain the flag PropertyAttnbute::MAYBEDEFAULT The prope.^ 
value must be available and of the specified type. If field PropertyAttribute in the stmcture Property contains Propert- 
vAttribute::MAYBEVOID, the value may be void. 

r02561 Value AMBIGUOUS.VALUE (Table 56) of the property is only a recommendation because there are mulftple 
values forthis property (e.g. from a multi selection). Field PropertyAttribute in structureP/Dpe/2'{Table 57) must contain 
Z PropertyAttribute-:MAYBEAMBlGUOUS. The property value must be available and of the specified type. If field 
Attribute in structure Property contains PropertyAttribute::MAYBEVOID. n the value may be void. 
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TABLE 56. : Enumeration PropertyState 



enum PropertyState 
{ 

DIRECT^VALUE, 
DEFAULT_VALUE, 
AMBIGUOUS VALUE 



); 



r02571 structure Property (Table 57) describes a property. There are three types of properties: bound properties, 
constrained properties and free properties. Field Name specifies the name of the property. The name .s un.que w.thin 
an XPropertySet. Field Handle contains an implementation specific handle for the property. The handle may be -1 i 
the implementation has no handle. Field Type contains an object that identifies the declared type for the property. If 
the property has multiple types or the type is not known, but not any. void must be returned. Field Attnbutes may contain 
zero or more constants of the PropertyAttribute constants group. 



TABLE 57 . : Structure Property 



struct Property 

{ 

string Name; 
long Handle; 
TYPE^XIDLCLASS Type; 
short Attributes; 
}; 



[02581 Exception NoSuchBementException (Table 58) is thrown by the method to indicate that there are no n 
elements in the enumeration. Exception NoSuchBementException inherits from exception Exception (Table 12). 
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TABLE 58.: EXCEPTION NoSuchElementException 



exception NoSuchElementException : 

com: :sun: :star: :uno: :Exception 

{ 

); 



[0259] As explained above, interface XFrame (Table 15) uses interface XFrameAct,onUstener (rab\B 59). Interface 
XFJ,eActionUstenert^ss to be provided it an object wants to receive events when several t^S^^,';^ PPf" t° ^^^^^^^^ 
nents within frames of the desktop, e.g., events of instantiation/destruction and actvation/deacbvaton of components 

So] Tntlrface XFrameActionUstener inherits from interface XEventUstener (Table 17). Method frameAction is 
called whenever any action occurs to a component within a frame. 



TABLE 59.: INTERFACE XfraraeActionListener 



interface XFrameActionListener: 

com: : sun : : star : : lang : : XEventListener 

{ 

[oneway] void frameAction ( [in] 

com: : sun: : star : : frame : : FrameActionEvent aEvent ) 



[0261] Event structure F/ame/^cfion£v.enf (Table60) is broadcast for action, which can happen to components within 
frames Event stnicture FrameActionEvent inherits from structure EventObject Oable 18). 

[S' In Table 60. field Frame contains the frame In which the event occurred. Field Action specrfies the concrete 
event. 
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Structure FrameActionEvent 



struct FrameActionEvent : 

com: :sun: :star: :lang: :EventObject 

{ 

com: : sun: :star ; : frame: :XFrame Frame; 

com: : sun: :star: : frame: : FrameAction Action; 

); 



20 Enumeration FrameAction (Table 61) specifies the events, which can happen to components in frames. An event 
COMPONENT.ATTACHED is broadcast whenever a component is attached to a frame. This is almost the same as 
the instantiation of the component within that frame. The component is attached to the frame immediately before this 
event is broadcast. An event COMPONENT.DETACHING is broadcast whenever a component is detaching from a 
frame. This is quite the same as the destruction of the component, which was in that frame. At the moment when the 

25 event is broadcast the component is still attached to the frame but in the next moment it is not attached. An event 
COMPONENT_REATTACHED is broadcast whenever a component Is attached to a new model. In this case the com- 
ponent remains the same but operates on a new model component. An event FRAME^ACTIVATED is broadcast when- 
ever a component is activated. Activations are broadcast from the top component, which was not active before, down 
to the inner most component. An event FRAME.DEACTIVATING broadcast immediately before the component is 

30 deactivated. Deactivations are broadcast from the innermost component, which does not stay active up to the outer 
most component, which does not stay active. An event CONTEXT_CHANGED is broadcast whenever a component 
changed its Internal context (i.e. the selection). If the activation status within a frame changes, this counts as a context 
change too. An event FRAME_U INACTIVATED is broadcast by an active frame when the active frame is getting user 
Interface control (tool control). An event FRAME.ULDEACTIVATING is broadcast by an active frame when the active 

35 frame is losing user Interface control (tool control). 
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TABLE 61 . : ENUMERATION FrameAction 



enum FrameAction 
{ 

COMPONENT_ATTACHED, 
COMPONENT_DETACHING , 
COMPONENT^REATTACHED, 
FRAME_ACTIVATED, 
FRAME_DEACTI VAT ING , 
FRAME_U I_ACT I VATED , 
FRAME_UI_DEACTIVATING 

}; 



[0263] AS described above, interface XDispatchProvider (Table 62 and Rg. 9) .s an interface of class BeanF^^^^^^ 
m l) interface XDispatchProvider pro.l6es Dispatch Interfaces for certain func^ons, which are useful a the user 
interfl.T^^^^ 

63) and structures URL (Table 64) and D/spato/7Descr/p tor (Table 67). 

TABLE 62.: INTERFACE XDispatchProvider 



interface XDispatchProvider: 

com: :sun: :star: :uno: :XInterface" 



com: : sun:: star:: frame: :XDispatch queryDispatch ( [in] 
com: :sun: rstar: :util: :URL aURL, 

[in] string aTargetFraraeName, 
[in] long nSearcliFlags ) ; 

sequence<com: : sun: : star: : frame: :XDispatch> 
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queryDispatches ( [in] 

sequence<com: : sun : : star : : frame : : DispatchDescriptor 
> aDescripts ) ; 



); 



[0264] Methodque,yDispatch(Table62)searchesforanXDispatchforthespecifiedURLw.m.nthespea 

E Method queryDisp^ches returns multiple dispatch interfaces for the specified descriptors at once. Actually th>s 

method Is redundant to method DispatchProvider::queryDispatch to avoid multiple remote calls 

roMBl Interface XDispatch (Table 63) sen/es state information of objects, which can be connected to control ers (e. 

g toL oSl^^^^^^^^^ Change is to be broadcast to all registered status listeners. The first no«f.cat.on 

shS?be perfom,ed synchronously. H not. controllers may flicker. State listener must be aware of th,s synchronous 

no i ation^The state includes enabled/disabled and a short descriptive text of the function e """^-"^f^/^^^^^^^ 

ter-) The state is to be broadcast whenever this state changes or the controller should reget the.value for the URL to 

whi h it is connected. Additionally, a context-switch-event is to be broadcast -J^-^^^^ ^^fi'^^^^^^^ 

to force the state listener to requery the XDispatch. Interface XDispatch inhents from interface Xlnterface (Table 2). 

TABLE 63.: INTERFACE XDispatch 



interface XDispatch: com: : sun: : star: :uno: : Xlnterface 

( 

[oneway] void dispatch ( [in] com: : sun: : star: :util : :URL 
aURL, [in] 

sequence<com: :sun: :star: : beans :: PropertyValue> 
aArgs ) ; 

[oneway] void addStatusListener ( [in] 

com: : sun: : star: : frame: : XStatusListener xControl, 
[in] com: : sun: : star: :util: : URL aURL ); 

[oneway] void removeStatusListener ( [in] 

com: : sun: : star: : frame: : XStatusListener xControl, 
[in] com: : sun: : star: rutil: : URL aURL ) ; 

}; 



[0266] Method dispatch (Table 63) dispatches (executes) an URL asynchronously Method dispatch is only allowed 
to dispatch URLs for which ttie current user gets the dispatch. Additional arguments or ?... are allowed. 
[0267] The following is an example for a click-handler of a hyperiink in a view. 
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XFrame xTargetFrame = m_xFrame- 
& gt ; f indFrame (m_aHyperlink- 

&gt;getTargetFrameName() , FRAME_SEARCH_STANDARD 
) ; 

URL aURL; 

aURL. Original = in_aHyperlink-&gt;getURL() ; 
XDispatch m_xFrame- & gt ; queryDispatch ( 
aURL, sequenceSamp;lt;PropertyValue&gt; 0 ); 
xDispatch-&arap;gt; dispatch ( aURL ); 

MPthod addStatusUstener (Table 63) registers a listener of a controller for a specific URL to this object to receive status 
ev^J?fhfs^2d y^^^^^ rUerfor URLs for wt,ich the currer,t user gets this dispatch. Add„.or,a, argu- 
ment?"* 'or -9 ..■ are ignored. Method removeStatusListener unregisters a listener of a controHer. 
raSsi StruJtur^ URL (Table 64) represents the original and the parsed structure of a Uniform Resource Locator It 
!s „olc"to2 alS^ the fields; either URL::Complete or (some of) the others are set. Add.t.onally. most of the 
other fields, like URL;:User, URL::Password or URL::Mark, are optonal. 
[0269] In Table 64, field C^omplete contains the unparsed original URL. for example, 
httD//me:pass©www.stardivlsion.de:8080/pub/test/foo.txt 

•?a-b#m Field Main contains the URL without a mark and without arguments, for example. 

htoSpaTs@wl stardivision.de:8080/pubrtest«oo.txt . Field Protocol contains the protocol (scheme) of the URL. 

?™pr"httrSetuL contains the u^^^^^ 

forexample, http .Hei^^^ Raid Server contains the server part of the URL. for example, "www. 

nartrrf th« URL Without the filename, for example, "/pub/test". Field Name contains the filename part of the URL. for 
the mark part of the URL, for example "xyz". 
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TABLE 64 . : STRUCTURE URL 



struct URL 

{ 

string Complete; 
string Main; 
string Protocol; 
string User; 
string Password; 
string Server; 
short Port; 
string Path; 
string Name; 
string Arguments; 
string Mark; 
}; 



r0270] As explained above. Interface XStatusListeneriJab\e 65) Is used by interface XDispatch (Table 63 and Figure 
9) Interface XStatusUstener ma\^es it possible to receive events when the state of a feature changes Interface XSte- 
to/./sfenerinherits from interface XEventListener (Jab\e 17). Method statusChanged is called when the status of the 
feature changes. 

TABLE 65-: INTERFACE XStatusListener 



interface XStatusListener: 

com: : sun : : star : : lang : : XEventListener 



[oneway] void statusChanged { [in] 

com:: sun:: star:: frame ;:FeatureStateEvent Event ); 



[0271] StructureFeaftyreSfafe£v/enf(Table66)isbroadcastbyacontroller.wheneverthest^^^ 
Structure FeatureStateEventmherWs from structure EventObject {Jab\e 18). 
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[02721 In Table 66 field FeatureURL contains the URL of the feature. Field FeatureDescriptor contains a descriptor 
of the feature for the user interface. Field IsEnabled specifies whether the feature Is currently enabled or disabled. 
Field Requery specifies whether the Dispatch has to be requeried. Field State contains the state of the feature in this 
dispatch. This can be. for example, simply TRUE for a Boolean feature like underline on/off. Some simple types like 
string or Boolean are useful here for generic user interface elements, like a checkmark in a menu. 



TABLE 66.: STRUCTURE FeatureStateEvent 



10 
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25 



Struct FeatureStateEvent: 

com: :sun: :star: :lang: :EventObject 

{ 

com: :sun: rstar: :util: :URL FeatureURL; 
string FeatureDescriptor; 
boolean IsEnabled; 
boolean Requery; 
any State; 
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[0273] structure DispatchDescriptor (Table 67) describes a feature to be retrieved by an URL that has to be loaded 
into a specified frame. Field FeatureURL specifies the URL of the resource/function. Field FrameName is the name of 
the target frame. Field SearchFlags Is how the target frame is to be searched. 



TABLE 67.: STRUCTURE DispatchDescriptor 
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Struct DispatchDescriptor 
{ 

com: :sun: :star: :util: :URL FeatureURL; 
string FrameName; 
long SearchFlags; 
}; 



55 [0274] In the embodiment of Figure 6, the component loaded is StarWriter. and class StarWriter includes interface 
XLoadable (Table 68 and Figure 9). Interface XLoadable provides functionality to implement objects, which may be 
loaded. Interface XLoadable inherits from interface XInterface (Table 2). 
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TABLE 68.: INTERFACE XLoadable 



rface XLoadable: com: : sun :: star :: uno :: XInterf ace 



inte 



[oneway] void loadO; 
[oneway] void unload!) ; 
[oneway] void reload (); 
boolean isLoadedO; 
[oneway] void addLoadListener ( [in] 
com 



:: sun: : star: : form: :XLoadListener aListener ); 



[oneway] void removeLoadListener ( [in] 

com: : sun: : star: : form: :XLoadListener aListener 



}; 



ro2751 Method load (Table 68) starts the data processing. Method unload stops the data Processing. Method ^^^^^^^^ 

rr'^ntr^^^^ in *e .oad listener .ethod calls In Table 68. Interface XLoadLjs- 

10276] interface ^'•ff a loadable object. The interface is typically implemented by 

Ustener inherits from Interface XEventUstener (Table 17). 

TABLE 69.: INTERFACE XLoadListener 



interface XLoadListener: 

com: : sun: : star: : lang: : XEventListener 

{ 

[oneway] void loaded ( [in] 

com :: sun :: star:: lang ::EventObject aEvent ), 

[oneway] void unloading ( [in] 

com: : sun:: star:: lang ::EventObject aEvent ) 

f oneway] void unloaded ( [in] _ — 
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com : : sun : : star : : lang : : EventOb j ect aEvent ) ; 
[oneway] void reloading ( [in] 

com: : sun: : star: : lang: : EventOb j ect aEvent ); 

[oneway] void reloaded ( [in] 

com: : sun : : star : : lang : : EventOb j ect aEvent ) ; 

}; ■ 



[0277] Method loaded CTable 69) is invoked when the object has successfully connected to a data source. Method 
Sing is invoked v.hen the object is about to be unloaded. Components may use th.s to ^t°PJ7 
pracessing related to the event source before the object is unloaded. Method unloaded .s invoked after the object has 
Steeled from a data source. Method reloading is invoked when the object is about to be reloaded. Co-nponents 
^a^use So stop any other event processing related to the event source until they get the reloaded event. Method 
rplnaded is invoked when the object has been reloaded. ...^ ^, . ^ ^ 

^781 Class BeanWindow (Fig. 6) includes interfaces XI/Wndo«.Peer (Table 70) and XEventHdl (Table 4)^ Interface 
SdowS^Z access to the actual window implementation on the device. Interface XIV,«dowPeer,nhents rorn 
fntelS oZonen^Table 1 6) . and uses i^^^^^ 
below. See also Figures 10A and 10B. 



TABLE 70.: INTERFACE XWindowPeer 



interface XWindowPeer : com : : sun : : star : : lang : : XComponent 
{ 



XToolkit getToolkitO; 

[oneway] void setPointer( [in] XPointer Pointer ); 
[oneway] void setBackground ( [in] long Color ); 
[oneway] void invalidate ( [in] short Flags ); 
[oneway] void invalidateRect ( [in] Rectangle Rect, [in] 
short Flags ) ; 

}; 



[02791 Method getToolWt (Table 70) returns the visual class, which created this object. Method setPointer sets the 
rnouse pointer. Method setBackground sets the background color. Method invalidate invahdates the whole window 
Sng anTvalidateStyle. MethodlnvalidateRectlnvalldatesa rectengularareaof the 
Si lllceX?ooM(Table71)specifiesafactorym^^ 

window toolkit (AWT) In JAVA. Interface XTooM Inherits from interface XInterlace (Table 2). 
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INTERFACE XToolkit 



10 



IS 



20 



interface XToolkit: com: : sun: : star: :uno: rXInterf ace 
{ 

com: : sun: : star: :awt: :XWindowPeer getDesktopWindow () ; 

com: : sun: : star: :awt: : Rectangle getWorkArea ( ) ; 

com: : sun: : star: :awt: :-XWindowPeer createWindow ( [in] 

com: : sun: : star: :awt: :WindowDescriptor Descriptor : 

raises ( 

com: : sun: :star: :lang: : IliegalArgumentException ) ; 
sequence<com: :sun: :star: :awt: :XWindowPeer> 
createWindows ( [in] 

sequence<com: : sun :: star :: awt :: WindowDescriptor> 
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Descriptors ) 
raises ( 

com: :sun: :star: :lang: : IliegalArgumentException ) 

com: :sun: :star: :awt: :XDevice 

createScreenCompatibleDevice ( [in] long Width, 
[in] long Height ) ; 
com: :sun: :star: :awt: rXRegion createRegion ( ) ; 
}; 



ro281 1 Method getDesktopWindow (Table 71 ) returns the desktop window. Method getWorkArea returns the complete 
SLa for this toolkit. Method createWindow creates a new window using the given descnptor. Method createWm- 
dow throws exception IlIegalArgumentExceptionrable 42). Method createWindows returns a sequence of w ndows. 
whTch a?e newly created using the given descriptors. Method createWindows throws excepton JllegalArgumentExcep- 
To^Merd crea^^ creates a virtual device that Is compatible with the screen. Method crea- 

STsSr^^ 72) describes a window Field Type specifies the type of window R^d 

dowSen^iceName specifies the name of the component service ("ListBox". TushButtonT A zero ength nar^e 
means that the vcl creates a blank top, a container, or a simple window Field Parent specifies the parent of the com- 
™t ^1^^^^^ 0 && Parentlndex == -1 . the window is on the desktop. Field Parent ndex specifies the .ndex 

Sf "e parf^^ if available. If Parent == 0 and this structure Is a member of an array, th.s .s the offset from the 

beginning of the array to the parent. A value of -1 means desktop. «ttrih.itA 
Field Bounds specifies the position and size of the window. This member .s ignored if the window attnbute is 
WA^FULLSIZE. Field WindowAttrlbutes contains some of the WA^ attnbutes. 
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TABLE 72 . : STRUCTURE WindowDescriptor 



struct WindowDescriptor 

com: :sun: :star: :awt: rWindowClass Type; 

string WindowServiceName; 

com: :sun: :star: :awt: :XWindowPeer Parent; 

short Parentlndex; 

com: :sun: :star: :awt: : Rectangle Bounds; 

long WindowAttributes; 

}; 



[0283] Enumeration mndaivC/ass(TabIe73)specifiestheclassofaw.ndow^ 

on the desktop It is also a container. Value MODALTOP is a modal top-level window on the desktop. It is also a 
container. Value CONTAINER is a container that may contain other components. It is not a top window 
Value SIMPLE is the simplest window. It can be a container. 



TABLE 73.: ENUMERATION WindowClass 



enum WindowClass 

{ 

TOP, 

MODALTOP, 
CONTAINER, 
SIMPLE 
}; 



[0284] I nterface XDevice (Table 74 and Figure 1 0A) provides infomiation about a graphical output device and offers 
a factory for the graphics, which provides write operations on the device. Interface XDevice mhents from interface 
XInterface (Table 2). 
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TABLE 74.: INTERFACE XDevice 
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interface XDevice: com: :sun: : star: :uno: :XInterface 
{ 

XGraphics createGraphics ( ) ; 

XDevice createDevice { [in] long nWidth, [in] long 
nHeight ) ; 

com: :sun: :star : : awt : zDevicelnfo getlnfoO ; 

sequence<FontDescriptor> getFontDescriptors () ; 

com: : sun: : star: : awt: :XFont getFont { [in] FontDescriptor 

aDescriptor ) ; 
XBitmap createBitmap ( [in] long nX, [in] long nY, 

[in] long nWidth, [in] long nHeight ); 
XDisplayBitmap createDisplayBitmap ( [in] XBitmap Bitmap 



) ; 



}; 



40 



[0285] Method createG raphics (Table 74) creates a new graphics, which output operation direct to this device. Method 
createDevice creates a new device, which is compatible with this one. If the device does not support the GETBITS 
device capability, this method returns NULL. Method getlnfo returns infomnation about the device. Method getFontDe- 
scriptors retums the list of available font descriptors. • . 
[0286] Method getFont (Table 74) returns infomnation about a font offered by this device. Parameter aDescnptor 
specifies the description of a font, and specifies that the unit of measure Is pixel for this device. 
[0287] Method createBitmap (Table 74) creates a bitmap with the current device depth. If the specified area does 
not lie entirely in the device, the bits outside are not specified. Method createDisplayBitmap creates a device-compatible 
bitmap The data of the bitmap is in process memory instead of in the device, so the output operation is fast. 
[0288] Interface XGraphics (Table 75) provides the basic output operation of a device. Interface XGraphics inhents 
from Interface Xinterface (Table 2). 
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INTERFACE XGraphics 



interface XGraphics: com: :sun: :star: :uno: :XInterface 
{ 

XDevice getDeviceO; 

SimpleFontMetric getPontMetric ( ) ; 

[oneway] void setFont ( [in] XFont xNewFont ); 

[oneway] void selectFont { [in] FontDescriptor 

aDescription ) ; 
[oneway] void setTextColor ( [in] long nColor ); 
[oneway] void setTextFillColor ( [in] long nColor ); 
[oneway] void setLineColor ( [in] long nColor ); 
[oneway] void setFillColor ( [in] long nColor ); 
[oneway] void setRasterOp( [in] RasterOperation ROP ); 
[oneway] void setClipRegion { [in] XRegion Clipping ); 
[oneway] void intersectClipRegion (. [in] XRegion 

xClipping ) ; 
[oneway] void pushO; 



80 



EP1 130 510 A2 

[oneway] void pop(); 

[oneway] void copy{ [in] XDevice xSource, [in] long 
nSourceX, [in] long nSourceY, [in] long 
nSourceWidth, [in] long nSourceHeight , [in] long 
nDestX, [in] long nDestY, [in] long nDestWidth, 
[in] long nDestHeight ); 
[oneway] void draw( [in] XDisplayBitmap xBitmapHandle, 
[in] long SourceX, [in] long SourceY, [in] long 
SourceWidth, [in] long SourceHeight, [in] long 
DestX, [in] long DestY, [in] long DestWidth, [in] 
long DestHeight ) ; 
[oneway] void drawPixel ( [in] long X, [in] long Y ); 
[oneway] void drawLine ( [in] long XI, [in] long Yl, 

[in] long X2, [in] long Y2 ); 
[oneway] void drawRect ( [in] long X, [in] long Y, [in] 

long Width, [in] long Height ); 
[oneway] void drawRoundedRect ( [in] long X, [in] long 
Y, [in] long Width, [in] long Height, [in] long 
nHorzRound, [in] long nVertRound ); 
[oneway] void drawPolyLine ( [in] sequence<long> DataX, 

[in] sequence<long> DataY ); 
[oneway] void drawPolygon( [in] sequence<long> DataX, 

[in] sequence<long> DataY ) ; 
[oneway] void drawPolyPolygon ( [in] sequence< 
sequence<long> > DataX, [in] sequence< 
sequence<long> > DataY ) ; 
[oneway] void drawEllipse( [in] long X, [in] long Y, 

[in] long Width, [in] long Height ); 
[oneway] void drawArc( [in] long X, [in] long Y, [in] 
long Width, [in] long Height, [in] long Xl, [in] 
long Yl, [in] long X2, [in] long Y2 ); 
[oneway] void drawPie( [in] long X, [in] long Y, [in] 
long Width, [in] long Height, [in] long XI, 
[in] long Yl, [in] long X2, [in] long Y2 ); 
[oneway) void drawChord( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long nHeight, [in] long 
nXl, [in] long nYl, [in] long nX2, [in] long nY2 
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) ; 

loneway] void drawGradient ( [in] long nX, [in] long nY, 
[in] long nWidth, [in] long Height, [in] Gradient 
aGradient ) ; 

[oneway] void drawText ( [in] long X, [in] long Y, 

[in] string Text ) ; 
[oneway] void drawTextArray ( [in] long X, [in] long Y, 
[in] string Text, [in] sequence<long> Longs ); 



p,lrOD ^te the raster operation If the device does not support raster operations, this call is ignored. Method set- 
Jnrpilnth^ 

Se Sut device Me^ drav^RoundedRect draws a rectangle Wrth rounded comers .n the ^"tP^,,^^^'''^ MettK,d 
rlwPoE^^^^^^ multiple lines in the output device at once. Method drawPolygon P^'^J- ^^^^^^^ 

device Method drawPolyPolygon dra«/s multiple polygons In the output device at once. Method drawElhpse draws an 
SSin ^eTutpSdevlL. Method drawArc draws an a 

a Sular^eat L oiiput device. Method drawCho«l draws a chord of a circular area in the output device^ A cho d 
fsTsetrieTo a ctrL get two Chords fr^^ 
n thToS mxL drawG?adient draws a color dispersion In the output device. •^^^f^^l-J^f 
output device. Method drawTextArray draws texts in the output device using an . ^^^^^ 

rOMOl Structure SImpleFontMetric (Table 76) describes the general metrics of a font. Field Ascent spec«es ttie 
porton of aTrer case Character that rises above the height of the character "x- of the font, f °^«7"P'«- *° '^IJ^f 
^T'hvLrhave an ascent ur,equaltoO.Ascent is measured in pixels, thus the fom 

Field Descent specifies the portion of a letter falling below the baseline. For example, the lette^ g p , and y have a 
delnruneS^^^ 

ie velal space between lines of this font, and is also called internal line spacing. The leading is measu e,d in pixels 
TusTefon SSe^^^^^ 

Tdegrees from 0 to 359. Field FirstChar specifies the code of the first pnntable character in the font. 
[0291] Field LastChar specifies the code of the last printable character in the font. 
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TABLE 76.: STRUCTURE. Simple FontMe trie 



struct SimpleFontMetric 
( 

short Ascent; 
short Descent; 

short Leading; 
char FirstChar; 
char LastChar; 
}; 



[0292] Interface XFont (Table 77) describes a font on a specific device. All values are in pixels within this device. 
Interface XFonf inherits from interface Xlnterface (Table 2). 

TABLE 77.: INTERFACE XFont 



interface XFont: com: : sun: : star : :uno: :XInterface 
{ 

com: :sun: :star: :awt: : FontDescriptor . 

getFontDescriptor ( ) ; 
com: :sun: :star: :awt: : SimpleFontMetric getFontMetric () ; 
short getCharWidth( [in] char c ); 

sequence<short> getCharWidths ( [in] char nFirst, [in] 

char nLast ) ; 
long getStringWidth { [in] string str ); 
long getStringWidthArray ( [in] string str, [out] 

sequence<long> aDXArray ) ; 
void getKernPairs{ [out] sequence<char> Charsl, [out] 
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sequence<char> Chars2, [out] sequence<short> Kerns 
) ; 

); 



[0293] Method getFontDescriptors (Table 77) returns the description of the font. Method getFontMetr.c returns ad- 
Uonalinforrnation about the font. MethodgetChaWidthreturnsthewidthof the specified character rne^^^ 
for the device. Method getCharWidths returns a sequence of the widths of subsequent characters for this *o"t- Method 
getStringWidth returns the width of the specified string of characters measured in pixels for the device. Method get- 
StringWidthArray returns the width of the specified string of characters measured in pixelsforthe device In this mettiod. 
parameter aDXArray receives the width of every single character measured in pixels for the device. Method getKem- 
Pairs queries the keming pair table. . . . » „„u„ 

[0294] Structure FontDescriptoriJaUB 78) describes the characteristics of a font. For example, this structu e can be 
used to select a font. Field Name specifies the exact name of the font ("Anal". "Courier", 
specifies the height of the font in the measure of the destination. Field Width «P«^f °* "1 

measure of the destination. Field StyleName specifies the style name of the font ("Bold" "Fett-. "^''^ Bold )^ Fie^ 
Family specifies the general style of the font. Use one value out of the constant group FontFamily. Field CharSet 
specifies the character set, which is supported by the font. Use one value out of the coristeint 3™"? CharSet. Field 
pitch specifies the pitch of the font. Use one value out of the constant group FontPitch. Field CharacterWidtt, specifies 
the character width. Depending on the specified width, a font that supports this width may be selected. The value is 

F^eW^ShT spedfierSthickness of the line. Depending on the specified weight, a font that supports this thickness 
may be selected. The value is expressed as a percentage. Field Slant specifies if there is a character slant (italic). 
Field Underiine uses one value out of the constant group FontUnderline. Field Strikeout uses one value out of the 
constant group FontStrikeout. Field Orientation specifies the rotation of the font. The unit of measure is degrees; 0 is 
the baseline. Reld Keming, for requesting, it specifies if there is a keming table available: for selecting 'tsf^cifies if 
the keming table is to be used. Field WordUneMode specifies if only words get underiined. A value of TRUE means 
that only non-space characters get underlir>ed while a value of FALSE means that the spacing also gets underlined. 
This property is only valid if the property FontDescripton:Underiine is not FontUnderline.NONE. Field Type specifies 
the technology of the font representation. One or more values out of the constant group FontType can be combined 
by an arithmetical or-operation. 

TABLE 78.: STRUCTURE FontDescriptor 



struct FontDescriptor 
{ 

string Name; 
short Height; 
short Width; 
string StyleName; 
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short Family; 

short CharSet; 

short Pitch; 

float CharacterWidth; 

float Weight; 

com: : sun: :star: :awt: : FontSlant Slant; 

short Underline; 

short Strikeout; 

float Orientation; 

boolean Kerning; 

boolean WordLineMode; 

short Type; 

}; 



[0295] Enumeration FontSlant (Jab\e 79) is used to specify the slant of a font. Value NONE specifies a font without 
slant. Value OBLIQUE specifies an oblique font (slant not designed into the font). Value ITALIC specifies an Italic font 
(slant designed into the font). Value DONTKNOW specifies a font with an unknown slant. Value REVERSE_.OBLIQUE 
specifies a reverse oblique font (slant not designed into the font). Value REVERSE_ITALIC specifies a reverse Italic 
font (slant designed into the font). 



TABLE 79.: ENUMERATION FontSlant 



enum FontSlant 
{ 

NONE; 

OBLIQUE, 

ITALIC, 

DONTKNOW, 

REVERSE OBLIQUE, 



REVERSE__ITALIC 
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[02961 The values in enumeration RasterOperatlon (Table 80) are used to specify the binary pixel-operation applied 
Uen pixels are written to the device. Value OVERPAINT sets all pixels as written in the output o^^^^^^ Value XOR 
uses the pixel written as one and the current pixel as the other operator of an exclusive or-operation. Value ZEROBITS 
J^sls aS bi^^^^ are affected by this operation, to be set to 0. Value ALLBITS causes all bits, wh.ch are affected 
by this operation, to be set to 1 . Value INVERT causes all bits, which are affected by this operation, to be inverted. 

TABLE 80-: ENUMERATION RasterOperatlon 



10 
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enum RasterOperatlon 

{ 

OVERPAINT, 
XOR, 

ZEROBITS, 

ALLBITS, 

INVERT 

}; 



[0297] interface XRegion (Table 81 and Figures 1 0A and 1 0B) manages multiple rectangles, which make up a region. 
Interface XRegion inherits from interface XInterface (Table 2). 
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TABLE 81.: INTERFACE XRegion 



interface XRegion: com: : sun: : star: :uno: :XInterf ace 
{ 

Rectangle getBounds { ) ; 
[oneway] void clear {); 

[oneway] void move ( [in] long nHorzMove, [in] long 
nVertMove ) ; 

[oneway] void unionRectangle ( [in] Rectangle Rect ); 
[oneway] void intersectRectangle ( [in] Rectangle Region 
) ; 

[oneway] void excludeRectangle ( [in] Rectangle Rect ); 
[oneway] void xOrRectangle ( [in] Rectangle Rect ); 
[oneway] void unionRegion( [in] XRegion Region ); 
[oneway] void intersectRegion ( [in] XRegion Region ); 
[oneway] void excludeRegion ( [in] XRegion Region ); 
[oneway] void xOrRegion ( [in] XRegion Region ); 
sequence<Rectangle> getRectangles ( ) ; 
}; 



40 
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[0298] Method getBounds (Table 81) returns the bounding box of the shape. Method clear makes this region an 
empty region. Method move moves this region by the specified horizontal and vertical delta. Method unionRectangle 
adds the specified rectangle to this region. Method intersectRectangle intersects the specified rectangle with the current 
region. Method excludeRectangle removes the area of the specified rectangle from this region. Method xOrRectangle 
applies an exclusive-or operation with the specified rectangle to this region. Method unionRegion adds the specified 
region to this region. Method intersectRegion intersects the specified region with the current region. Method exclude- 
Region removes the area of the specified region from this region. Method xOrRegion applies an exclusive-or operation 
with the specified region to this region. Method getRectangles returns all rectangles, which are making up this region. 
[0299] Interface XDisplayBitmap (Table 82) specifies an object as a bitmap for which data is formatted for a specific 
output device. Drawing of this bitmap is only valid on a compatible device. Interface XDisplayBitmap inherits from 
interface XInterface (Table 2). 
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TABLE 82.: INTERFACE XDisplayBitmap 



10 
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interface XDisplayBitmap: 

com: :sun: :star: :uno: rXInterface 

{ 



[0300] structure Gradient (Table 83) describes a color dispersion within an area. Field Style speci^es the style o 
the gradient. Field StartColor specifies the color at the start point of the gradient. Field EndColor specifies the color at 
the end point of the gradient. Field Angle specifies the angle of the gradient in 1/1 0 degree. Field Border specifies the 
percent of the total width where just the start color is used. Field XOffset specifies the X-coordinate, where gradien 
begins Field YOffset specifies the Y-coordinate, where gradient begins. Field Startlntensity specifies the intensity a 
the start point of the gradient. Field Endlntensity specifies the intensity at the end point of the gradient Field StepCount 
specifies the number of steps of change color. 
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TABLE 83.: STRUCTURE Gradient 
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Struct Gradient 



{ 



com: : sun: :star: :awt: :GradientStyle Style; 

long StartColor; 

long EndColor; 

short Angle; 

short Border; 

short XOffset; 

short YOffset; 

short Startlntensity; 

short Endlntensity; 

short StepCount; 

}; 



[0301] Enumeration GradientStyle (Table 84) specifies the style of color dispersion. Value LINEAR speciftes a linear 
qradient Value AXIAL specifies an axial gradient. Value RADIAL specifies a radial gradient. Value ELLIPTICAL spec- 
ifiesan elliptical gradient. Value SQUAREspecifiesagradientinthe shape ofasquare.ValueRECTspecifiesagradie^^ 

in the shape of a rectangle. 
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TABLE 84.: ENUMERATION GradientStyle 



enum GradientStyle 

{ 

LINEAR, 



AXIAL, 

RADIAL, 

ELLIPTICAL, 

SQUARE, 

RECT 

}; 



[0302] Structure Devicelnfo (Table 85) contains information about a device. Field Width contains the width of the 
device in pixels. Field Height contains the height of the device in pixels. Field Leftlnset contains the inset from the left. 
Field Toplnset contains the inset from the top. Field Rightlnset contains the inset from the right. Field Bottomlnset 
contains the inset from the bottom. Field Pixel PerMeterX contains the X-axis resolution of the device in pixel/meter. 
Field PixelPerMeterY contains the Y-axis resolution of the device in pixel/meter. Field BitsPerPixel contains the color- 
depth of the device. Field Capabilities specifies special operations, which are possible on the device. 



TABLE 85.: STRUCTURE Devicelnfo 



struct Devicelnfo 
{ 



long 


Width; 


long 


Height; 


long 


Leftlnset; 


long 


Toplnset; 


long 


Rightlnset; 


long 


Bottomlnset; 



double PixelPerMeterX; 
double PixelPerMeterY; 
short BitsPerPixel; 
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long Capabilities; 
}; 



[0303] Interface XBitmap (Table 86) provides a bitmap in the Microsoft DIB format. Interface XBitmap Inherits from 
Interface Xlnterface (Table 2). Method getSize returns the size of the bitmap in pixels. Method getDIB returns the device 
Independent bitmap. Method getMaskDIB returns the transparence mask of the device Independent bitmap. 



TABLE 86.: INTERFACE XBitmap 



interface XBitmap: com:: sun: zstar: :uno: : Xlnterface 
{ 

com: :sun: :star: :awt: :Si2e getSizeO; 
sequence<byte> getDIBO; 
sequence<byte> getMaskDIB (); 
}; 



[0304] Stnjcture Size (Table 87) specifies the two-dimensional size of an area using width and height. Field Width 
specifies the width. Field Height specifies the height. 

TABLE 87.: STRUCTURE Size 



struct Size 

{ 

long Width; 
long Height; 
1; 



[0305] Interface XPointer (Table 88) gives access to the type of mouse pointer. Interface XPo/nfer inherits from in- 
terface Xlnterface (Table 2). Method setType selects a SystemPointer for this mouse pointer. IVIethod getType returns 
the currently set SystemPointer of this mouse pointer. 
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INTERFACE XPointer 



interface XPointer: com: :sun: :star: :uno: :XInterface 
{ 

toneway] void setType( [in] long nType ); 
long getType ( ) ; 



}; 



[0306] Table 89 is one embodiment of a remote virtual device interface XRmVirtualDevice that is included in one 
embodiment of lightweight component 230. 



TABLE 89.: INTERFACE XRmVirtualDevice 



interface XRmVirtualDevice : 

com: :sun: :star: :uno: :XInterface 

I 

[oneway] void Create ( [in] unsigned long nCompDev, 

[in] long nWidtli, [in] long nHeight, [in] unsigned 

short nBitCount ); 
[oneway] void SetOutputSizePixel ( [in] long nWidth, 

[in] long nHeight ); 
[oneway] void ResizeOutputSizePixel ( [in] long nWidth, 

[in] long nHeight ) ; 

}; 



[0307] Table 90 is one embodiment of interfaces XRmBitmap and XRmJavaBitmap that are included in one embod- 
iment of lightweight component 230. These interfaces are used when a runtime environment component on server 
cpmputer system needs to display a bitmap on user device 1021. 
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TABLE 90.: INTERFACES XRmBitmap and XRmJavaBitmap 



interface XRmBitmap : com; :sun: :star: :uno: :XInterf ace 
{ 

InitiateTransf er : initialize bitmap to empty with 
width, height and depth the next parameters 
determine the format of the scanlines transported 
by subsequent Transfer calls: palette for palette 
bitmaps, the palette entries are in the order 
blue (or index), green, red, bool. the bool tells 
whether the first byte is an index or not. 
(implementation detail: this is a vol BitmapColor) 
format and scanlinesize determine how to interpret 
the scanlines transported in each Transfer call, 
compressiontype marks the compression algorithm 
used on the byte sequences in Transfer call with 0 
meaning uncompressed. InitiateTransfer with width 
and height set to 0 is legal, the bitmap data 
should be purged then. 

*/ 

[oneway] void InitiateTransfer! [in] long width, 

[in] long height, [in] long depth, [in] sequence< 
byte > palette, [in] long format, [in] long 
scanlinesize, [in] long compressiontype ); 

/** 

* Transfer: transports one or more scanlines of the 
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bitmap initialized in InitiateTransf er . 

*/ 

toneway] void Transfer ( [in] ByteSequence aData ); 

unsigned long QueryBitmapPtr ( ) ; 

[oneway] void Draw ( [in] long nDestX, [in] long 
nDestY, [in] long nDestWidth, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 
[in] long nSrcWidth, [in] long nSrcHeight, [in] 
XRmOutputDevice xOutputDevice ) ; 

[oneway] void DrawEx ( [in] long nDestX, [in] long 
nDestY, [in] long nDestWidth, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 
[in] long nSrcWidth, [in] long nSrcHeight, [in] 
XRmBitmap xBitmap, [in] XRinBitmap xBitmapMask, 
[in] XRmOutputDevice xOutputDevice, [in] boolean 
bAlplia ) ; 

[oneway] void DrawMask{ [in] long nOestX, [in] long 
nDestY, [in] long nDestWidtli, [in] long 
nDestHeight, [in] long nSrcX, [in] long nSrcY, 
[in] long nSrcWidth, [in] long nSrcHeight, [in] 
XRmBitmap xBitmap, [in] unsigned long nColor, [in] 
XRmOutputDevice xOutputDevice ) ; 

[oneway] void CreateBitmap ( [in] long nX, [in] long 
nY, [in] long nWidth, [in] long nHeight, [in] 
XRmOutputDevice xOutputDevice ) ; 

void GetBitmap( [out] ByteSequence rData ); 

1; 

interface XRmJavaBitmap : XRmBitmap 
{ 

[oneway] void SetlmageData ( [in] long nBitCount, [in] 
long nWidth, [in] long nHeight, [in] ByteSequence* 
aColorMap, [in] ByteSequence aIndexData, [in] 
LongSequence aRGBData) ; 

void GetlmageData ( [out] long rBitCount, [out] long 
rWidth, [out] long rHeight, [out] ByteSequence 
rColorMap, [out] ByteSequence rBitmapData, [out] 
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LongSequence rRGBData, [out] long rAlphaMask, 
[out] long rRedMask, [out] long rGreenMask, [out] 
long rBlueMask); 



[0308] Table 91 is one embodiment of interfaces XRmPrintObserver, XRmPrinterEnvironment, XRmPrinter, and 
XRmPrintSpoolerXhat are included in one embodiment of lightweight component 230. These Interfaces are used when 
a runtime environment component on server computer system needs to print to a printer coupled to user device 102i. 



TABLE 91.: INTERFACES XRmPrintObserver, 
XRmPrinterEnvironment, XRmPrinter, and XRmPrintSpooler 



{ 



II [in] Eingabe-Parameter . Der "Server" auf dem das 

Object liegt ist der Remote-Client. 
// Also "Server" eigentlich "Display" 
// [oneway] => Kein warten auf Antwort 
typedef sequence< byte, 1 > RmJobSetup; 
typedef ■ sequence< byte, 1 > RinQueueInf o; 
typedef sequence< byte, 1 > RmPrinterPage; 
typedef sequence< string, 1 > StringSequence; 

interface XRmPrinterObserver : 

com: :sun: :star: :uno: iXInterface 

{ 

[oneway] void PrinterSettingsChanged { ) ; 
); 

interface XRmPrinterEnvironment : 

com: :sun: :star: :uno: :XInterface 
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I 

unsigned short GetQueueCount () ; 

void GetQueueInfo( [in] unsigned short nQueue, [out] 

RmQueueInf o rRmQueuelnf o ) ; 
boolean GetPrinterInf o ( [in] string sPrinterName, 

[out] RmQueuelnfo rRmQueuelnf o ); 
void GetPrinterNames ( [out] StringSequence 

rPrinterNames ) ; 
stringGetDef aultPrinterName ( ) ; 

void SetObserver( [in] XRmPrinterObserver rObserver ); 

}; 

interface XRmPrinter : com: : sun: : star : :uno: iXInterface 
{ 

void Create ( [in] RmQueuelnfo aRmQueueInf o, [out] 

RmJobSetup rRmJobSetup ) ; 
boolean SetJobSetupt [inout] RmJobSetup rRmJobSetup ) 
boolean SetOrientation { [in] unsigned short 

nOrientation, [inout] RmJobSetup rRmJobSetup ); 
boolean SetPaperBin( [in] unsigned short nPaperBin, 

[inout] RmJobSetup rRmJobSetup ); 
boolean SetPaper( [in] unsigned short nPaper, [inout] 

RmJobSetup rRmJobSetup ) ; 
boolean SetPaperSizeUser ( [in] long nWidth, [in] long 

nHeight, [inout] RmJobSetup rRmJobSetup ); 
void GetPageInfo( [out] long rOutWidth, [out] long 

rOutHeight, [out] long rPageOffX, [out] long 

rPageOffy, [out] long rPageWidth, [out] long 

rPageHeight ) ; 
unsigned short GetPaperBinCount () ; 
string GetPaperBinName ( [in] unsigned short 

nPaperBin ) ; 

/** query the printer for its capabilities (mainly to 
decide whether it is possible to bring up a 
printer setup dialogue) 

*/ 

unsigned long GetCapabilities ( [in] unsigned short 
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nType ) ; 

brings up a UI to setup the current jobsetup. 
Returns the modified (and still current ) jobsetup 
if successful. If not successful (e.g. user 
cancel) the return is empty. Mote: return is 
delivered as a UserEvent on the EventListener of 
xParent 

*/ 

[oneway] void UserSetup{ [in] XRmFrameWindow xParent, 
[in] unsigned long EventID ) ; 

}; 

interface XRmSpoolLauncher : 

com: :sun: :star: :uno: :XInterface 

{ 

boolean LaunchSpooler ( [in] string sUserName, [in] 
string sPassword ) ; 

}; 

interface XRmPrintSpooler : 

com: :sun: :star: :uno: rXInterface 

{ 

void Create( [in] RmJobSetup jobSetup ); 

boolean Start Job ( [in] unsigned short nCopies, [in] 
boolean bCollate, [in] string aJobName, [in] 
string . sFileName , [in] boolean bPrintFile) ; 

[oneway] void SpoolPage( [in] RmPrinterPage page ); 

void Abort Job ( ) ; 

void End Job () ; 

}; 

}; 



[0309] Table 92 is one embodiment of interface XRmFHeStream. Table 93 is one embodiment of interface XRmFSys. 
Both of these interfaces are included in one embodiment of lightweight component 230. These interfaces are used 
when a runtime environment component reads or writes data on a storage medium of user device 1021, or needs to 
obtain information about data stored on a storage medium of user device 102i. in this embodiment, object BeanService 
532 receives, as described above, a handle to object ClientFactory 515. The handle to object ClientFactory 515 to 
instantiate an object on the user device to access a particular capability on the user device, e.g., the file system, printing, 
sound, etc. 
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TABLE 92.: INTERFACE XRmFxleStream 



{ 

typedef sequence< byte, 1 > RFSByteSequence; 
interface XRmFileStream : 

com: : sun : : star : : uno : : XInterf ace 
{ // interface 

// param aPilename: file to open 

// param nOpenMode : file mode read 

// param bIsOpen: file opend successfully 

// param bIsWritable: file opend writable 

// param nStreamMode: stream mode 

// param nError: Error Code 

// returns fileHandle: handle 

unsigned long open { [in] string aFilename, 

[in] unsigned short nOpenMode, [out] boolean 
bIsOpen, [out] boolean bIsWritable, [out] 
unsigned short nStreamMode, [out ] unsigned long 
nError) ; 

// param handle: filehandle 

void close {) ; 

// param aData: data read from stream 
// param nSize: number of bytes to read 
// param nError: errorcode 

// returns: number of bytes that were successfully read 
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unsigned long getData ( [out ] RFSByteSequence aData, 
[in] unsigned long nSize, [out] unsigned long 
nError) ; 

// param nData: data to write to stream 

// param nSize: number of bytes to write 

// param nError: error code 

// returns; number of bytes that were successfully 

// written 

unsigned long putData([in] RFSByteSequence aData, [in] 
unsigned long nSize, [out] unsigned long nError) ; 
// param nPos: desired position 
// param nError: errorcode 
// returns: new position 

unsigned long seekPos{[in] unsigned long nPos, [out] 

unsigned long nError) ; 
// param nSize: new filesize 
// param nError: errorcode 

Void setSize([in] unsigned long nSize, [out] unsigned 

long nError) ; 
// param nSyteOffset: where to start locking 
// param nBytes: how many bytes to lock 
// param nError: errorcode 
// returns: success 

boolean lockRange ( [in] unsigned long nByteOffset, [in] 
unsigned long nBytes, [out] unsigned long nError); 
// param nByteOffset: where to start unlocking 
// param nBytes: how many bytes to unlock 
// param nError: errorcode 
// returns: success 

boolean unlockRange ( [in] unsigned long nByteOffset, 
[in] unsigned long nBytes, [out] unsigned 
longnError) ; 

};}; 
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TABLE 93.: INTERFACE XRmFSys 



I 

struct FileStatMembers 

( 



unsigned 


long 


nError ; 


unsigned 


long 


nKindFlags; 


unsigned 


long 


nSize; 


string 




aCreator; 


string 




aType; 


unsigned 


long 


aDateCreated; 


unsigned 


long 


aTimeCreated; 


unsigned 


long 


aDateModif led; 


unsigned 


long 


aTimeModif ied; 


unsigned 


long 


aDateAccessed; 


unsigned 


long 


aTimeAccessed; 



); 

typedef sequence< string, 1 > DirEntrySequence; 
typedef sequence< FileStatMembers, 1 > 

Fi leS tat Sequence; 
typedef sequence< unsigned long, 1 > FSysSortSequence; 

interface XRmFSys : com: : sun: : star : :uno: iXInterf ace 
{ // interface 

boolean isCaseSensitive ( [in] string aDirEntry) ; 
string tempName ([in] string aDirEntry, [in] unsigned 
long eKind) ; 

boolean toAbs ( [in] string aDirElntry, [out] string 
aResult) ; 

boolean toRel ( [in] string aDirEntry, [out] string 
aResult) ; 

boolean toRelRel ( [in] string aDirEntry, [in] string 
aRelative, [out] string aResult) ; 



99 



EP1 130 510 A2 



boolean makeShortName ( [inout] string aDirEntry, [in] 
string aLongName, [in] unsigned long nCreateKind, 
[in] boolean bUseTilde, [in] unsigned long 

nStyle) ; 

unsigned short scan ( [in] string aDirEntry, [out] 
DirEntrySequence aDirEntryList , [out] 
FileStatSequence aFileStatList, [in] 
FSysSortSequence aSortLst, [in] string aNameMask, 
[in] unsigned short nAttrMask, [in] boolean 
bFillFileStatList) ; 

boolean update ( [out] FileStatMembers aFileStat, [in] 
string aDirEntry, [in] boolean 
bAccessRemovableDevice) ; 

unsigned long queryDiskSpace ( [in] string aPath, [out] 
unsigned long nFreeBytes, [out] unsigned long 
nTotalBytes) ; 

string getDevice ( [in] string aDirEntry) ; 

string getVolume ( [in] string aDirEntry) ; 

unsigned long getPathStyle { [in] string aDevice) ; 

boolean hasReadOnlyFlag ( ) ; 

boolean getReadOnlyFlag ( [in] string aDirEntry) ; 
boolean exists ( [in] string aDir, [in] unsigned long 
nAccess) ; 

boolean first ( [inout] string aDir) ; 

boolean find ( [in] string aDirEntry, [in] string 

aPfad, [in] char cDelim, [out] string aResult) ; 
boolean setCWD ( [in] string aDir, [in] boolean 

bSloppy) ; 

boolean makeOir ( [in] string aDir, [in] boolean 
bSloppy) ; 

long setReadOnlyFlag ( [in] string aDirEntry, [in] 
boolean bRO) ; 

void setDateTime ( [in] string aFileName, [in] unsigned 
long nDate, [in] unsigned long nTime) ; 

unsigned long moveTo ( [in] string aFromDir, [in] 
string aToDir) ; 

unsigned long kill ( [in] string aFromDir, [in] unsigned 
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long nActions) ; 

); 

); 



[031 0] Table 94 is one embodiment of interfaces XSoundCallBack and XRMSound ihaX are included in one embod- 
iment of liglitweight component 230. These interfaces are used when a runtime environment component needs to play 
sounds on user device 102i. 

TABLE 94.: INTERFACES XSoundCallBack and XRMSound 



{ 

II SoundSequence 

typedef sequence< byte, 1 > SoundSequence; 

// SoundCallback 

interface XSoundCallback : 

com: :sun: :star: luno: :XInterface 

{ 

[oneway] void Notify ( [in] unsigned short 

nNotif ication, [in] unsigned long nError ) ; 

}; 

// XRmSound 

interface XRmSound : com: :sun: :star: runo: :XInterface 

{ 

[oneway] void Create ( [in] XSoundCallback 

XSoundCallback ) ; 
unsigned long Transfer ( [in] unsigned long nExtraData, 

[in] SoundSequence aData, [in] string aFileName ); 
[oneway] void SetStartTime { [in] unsigned long 

nStartTime ) ; 

[oneway] void SetPlayTime( [in] unsigned long nPlayTime 
) ; 
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[oneway] void SetLoopMode( [in] boolean bLoop ); 

[oneway] void ClearError ( ) ; 

[oneway] void PlayO; 

[oneway] void StopO; 

[oneway] void Pause (); 

); 



}; 



[031 1 ] Table 95 is one embodiment of interface XRmStatus that is included in one embodiment of lightweight com- 
ponent 230. This interfaces is used when a runtime environment component needs the status of user device 102i. 



TABLE 95.: INTERFACES XRmStatus 



interface XRmStatus : com: : sun: : star :: uno: rXInterf ace 
{ 

unsigned long GetRemoteVersion ( ) ; 
unsigned long GetSystemType { ) ; 
unsigned long GetSystemCharSet { ) ; 

void ShowError( [in] string aMsg, [in] unsigned short 
nCode ) ; 

void ShowWarning( [in] string aMsg, [in] unsigned short 
nCode ) ; 

void Showlnfo( [in] string aMsg, [in] unsigned short 

nCode ) ; 
void Quit ( ) ; 
1; 
1; 



[0312] Those skilled in the art will readily understand that the operations and actions described herein represent 
actions performed by a CPU of a computer in accordance with computer instructions provided by a computer program. 
Therefore, lightweight component 230 may be implemented by a computer program causing the CPU of the computer 
to carry out Instructions representing the individual operations or actions as described hereinbefore. The computer 
instructions can also be stored on a computer-readable medium, or they can be embodied in any computer-readable 
medium such as any communications link, like a transmission link to a LAN, a link to the internet, or the like. 
[031 3] Thus, lightweight component 230 can be Implemented by a computer program comprising computer program 
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code or application code. This application code or computer program code may be embodied in any form of a computer 
program product. A computer program product comprises a medium configured to store or transport this computer- 
readable code, or in which this computer-readable code may be embedded. Some examples of computer program 
products are CD-ROM discs, ROM cards, floppy discs, magnetic tapes, computer hard drives, servers on a network, 

5 and carrier waves. The computer program product may also comprise signals, which do not use carrier waves, such 
as digital signals transmitted over a network (including the Internet) without the use of a carrier wave. 
[031 4] The storage medium including the applications/services executed on a server may belong to server computer 
system 100 itself. However, the storage medium also may be removed from server computer system 100. The only 
requirement is that the applications/services are accessible by server computer system 100 so that the application/ 

10 service corresponding to lightweight component 230 can be executed by sender 100. 

[0315] Herein, a computer memory refers to a volatile memory, a non-volatile memory, or a combination of the two 
in any one of these devices. Similariy, a computer input unit and a display unit refer to the features providing the required 
functionality to input the information described herein, and to display the information described herein, respectively, in 
any one of the aforementioned or equivalent devices. 

15 [0316] While the present invention has been explained In connection with certain embodiments thereof, other em- 
bodiments will be apparent to those skilled in the art from consideration of the specification and practice of the embod- 
iment of the present invention disclosed therein. It is intended that the specification and examples be considered as 
exemplary only, without limiting the spirit and scope of the invention. 

[0317] In the following, further embodiments of the invention will be described with respect to figs. 11 - 22. 
20 [031 8] The embodiments may be implemented in a software system for providing the functionality (i.e. the services) 
of runtime environment components from a server computer system via a network to one or several client computer 
systems. 

[0319] The software system consists of two parts, one of them being executed on a client, the other residing and 
being executed on the server. The part on the server platform makes up the runtime environment comprising a plurality 

25 of runtime environment components which are able to provide services. Furthermore, the part on the server provides 
the necessary communication tools In order to communicate with the client. The other part, being executed on the 
client, performs mainly the communication between the client requesting a runtime environment component service 
and the part being executed on the server which renders the runtime environment component service requested. The 
server's part of the software system is by far larger in size than the client's part thereof. This latter part is referred to 

30 as the 'lightweight component'. A typical size of the software system's part on the server may be 50 to 100 Megabyte 
(e.g.: an office software package), whereas the lightweight component on the client may have a typical size of 400 
Kilobyte, and may utilize only little system resources (CPU power, memory). 

[0320] The small size of the lightweight component makes it attractive to download It within very short time from the 
server to a client when the corresponding runtime environment component service is actually needed. Then, via the 
35 lightweight component, the client has access to all the services presented by the mntime environment components 
hosted on the sen/er. 

[0321 ] The lightweight component provides an application programming interface (API) for any application program 
the implementation of which on the client is allowed by an implementation framework on the server. Two types of 
lightweight components are explained in the following, one being a standard component (referring to Figures 11 to 14), 

40 the other being a component rendering visual functionality (referring in particular to Figures 15 to 1 9) . 

[0322] Computer Software programs and parts thereof, which are called during execution of other computer software 
programs or parts thereof, are referred to as runtime environment components. The functionality provided by these 
njntime environment components to calling software programs or parts thereof are referred to as runtime environment 
component services. In many cases, runtime environment components have a very large size. For example, office 

45 suites comprising drawing programs and wordprocessors as well as other tools may have sizes of 50 to 1 00 Megabyte 
which renders a distribution over the Internet difficult. The runtime environment components may be implemented in 
any suitable form. They may consist of compiled software program code to be executed or of script code in any pro- 
gramming language to be Interpreted before execution by a compiler. Runtime environment components are typically 
stored and administrated on a server. 

50 [0323] The runtime environment component services, that means the functionalities provided by runtime environment 
components, which are, for example, stored on a server, are made available for use in software programs to be executed 
on, for example, clients without integrated them into these software programs and without distributing them together 
with these software programs to the place of execution, for example, the clients. 

[0324] Further, functionality of the runtime environment components should is made available for all kinds of clients 
55 whether they are powerful enough for storing or executing the runtime environment component or not. Further, the 
user of a client is not charged with the problem whether a specific runtime environment component is available on his 
client or not. 

[0325] Reference is made to Fig. 11 , which illustrates the communication between the server 111 and an arbitrary 
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numberof clients 11 2A, 11 2B which areconnected via communication network 11 3. The server 111 presents the runtime 
environment component sen^ices to the clients 112A, 112B. Sen/er 111 hosts components 1101, 1102, 1103, 1104, 
1105, 1106 of the runtime environment as well as a component 1100 for communication with the clients 112A, 112B 
via a network 113. The network 113 is here assumed to be the Internet, although any other network may be used as 

5 well. Each client 11 2A, 1128 Is adapted to execute (at least) one software program 1250. 

[0326] On each of the clients 1 1 2A, 1 1 28 a lightweight component 1 21 0 is implemented, which provides services of 
the runtime environment components 1101, 1102, 1103, 1104, 1105, 1106 hosted on server 111 to a software program 
1250 running on the clients 112A, 1128. The communication with sen/er 111 is performed by the communication com- 
ponent 1200 via the network 113. It is to be noted that the lightweight component 1210 may initially not be available 

10 on the clients 1 1 2A, 1 1 2B. In this case, the lightweight component 1 21 0 may be downloaded on the clients 1 1 2A, 11 2B, 
for example, from the sen/er 111 upon the first request for runtime environment component services which are acces- 
sible by means of the lightweight component 1210. 

[0327] It is assumed that on the clients 11 2A, 1128 a software program 1 250 (e.g.: an Internet browser) is executed. 
Whenever the software program 1 250 calls for a runtime environment component, for example an AP1 1 1 01 for providing 
IS a mathematical function, the lightweight component 1210 receives this call. The lightweight component 1210 then 
transforms this call into a request and transmits it via the communication component 1200, the network 113 and the 
communication component 1100 to the server 111 , where the API component 1101 called for is residing. 
[0328] Fig. 12 to 14 now illustrate the processing for presenting / providing the runtime environment component 
services in more detail. 

20 [0329] Referring to Fig. 12, the lightweight component 1210 receives a call for an API component 1101 from the 
software program 1250 running on the client 11 2A. With the call, data (e.g. arguments) necessary for performing the 
requested runtime environment component service of API component 1101 is received. The lightweight component 
1 21 0 transfomns the received call into a request to be transmitted over the network 1 1 3 to the server 1 1 1 which actually 
hosts the runtime environment, including the now requested API component 1101 . 

25 [0330] The transmission of the request over the network 1 1 3 is perfonned according to a predetermined transmission 
protocol. The transmitted request contains the data (e.g. arguments) from the calling software program 1 250 for being 
processed by the API component 1101 . If the network 113 is publicly accessible, the transmission may be encrypted 
according to known technologies. Further, digital signatures can be used to provide certification of the request mech- 
anism being established on the client for this runtime environment component services system. 

30 [0331] The request is received by the server 111 on which the appropriate communication component 1100 is exe- 
cuted. The communication component 1100 transfonns and decrypts (If necessary) the transmitted request, performs 
digital signature processing, and accesses the requested API component 1101 implementing the desired mathematical 
function. This API component 1101 is executed on the server 111 , whereby the data (e.g. arguments) received with 
the request are processed. The result thereof is encrypted (if necessary) by the communication component 1100 and 

35 transmitted from the server 111 back to the client 112A, 

[0332] The lightweight component 1210 on the client receives and re-transforms the result (and decrypts it, if nec- 
essary) and provides the result to the software program 1250 having called for the sen/ice of the API component 1 1 01 . 
[0333] Thus, the lightweight component 1 21 0 on the client 1 1 2A delegates calls to the API component 1101, which 
may be part of an Implementation framework on the sen/er 111 . The lightweight component 1210 operates hidden to 

40 the calling software program of the client 11 2A. The called runtime environment component 1101 is executed on the 
server 111. However, the calling software program 1250 on the client 112A does not notice whether the execution of 
the runtime environment component 1101 Is local, I.e. on the client 112A, or remote, i.e. on the server 111. The calling 
software program 1250 does not need to be modified for the use with the lightweight component 121 0, since, the call 
for a runtime environment component is 'intercepted' and transformed into a suitable request to the server 111 by the 

45 lightweight component 1210, according to the invention. 

[0334] On the other hand, local sen/ices available on the client 1 1 2A, Including devices like printers and local storage, 
can also be utilized by the runtime environment components on the server 111 , in a transparent manner. Transformation 
of the call of the software program 1 250 to the lightweight component 1 21 0 and re-transformation of the result received 
from the server 111 are performed "on the fly". 

50 [0335] Fig. 1 3 illustrates the implementation of the lightweight component 1 21 0. As mentioned above, the component 
1210, which is necessary for transfonning the call can be kept relatively small. It can have a small installation size and 
low usage of resources compared to the runtime environment components on the sen/er 111 . 
[0336] Fig. 1 4 exemplary illustrates the transparent access of a runtime environment component via an object com- 
ponent model. The object component model handles calls by marshaling requests for njntime environment component 

55 services through stub objects 1 200' on the client 1 1 2A and transmitting it over the network 1 1 3 to the server 111. There, 
the requests are unmarshaled through proxy objects 1100'. 

[0337] The stub objects 1200' and the proxy objects 11 00' are generated dynamically, for example, by the commu- 
nication component 1200 and by the communication component 1100, respectively. Therefore, a caller does not have 
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to implement the stub objects 1200' and the proxy objects 1100'. 

[0338] Marshalling of a request is, in the present context, understood as the process of embedding a request for a 
runtime environment component service in a bit stream for transmission over a network. The unmarshalling is the 
inverse process of the marshalling. 
5 [0339] The transmission concept through stub and proxy objects is described in more detail in the Annex. 

[0340] The stub / proxy object component model used here Implies that a lightweight component is able to access 
any arbitrary runtime environment component 1101 , 1102, 1103, 1104, 1105, 1106 available on the server 111 . as if it 
resided locally on the client 112A. 

[0341 ] Referring to Figures 1 5 to 1 7, a further embodiment of a lightweight component 1 21 0 is explained. The com- 
10 munication between the server 111 and the client 112A is performed via the network 11 3 by the respective communi- 
cation components 1 1 00 on the server 1 1 1 . and 1 200 on the client 1 1 2A. The same encryption / decryption mechanisms 
as Indicated above may be applied. In addition to the basic generic lightweight component 1210 as described in con- 
nection with Figures 11 to 14, the lightweight component 1210 may include the ability to perform graphic interaction 
and to manage user interaction. In the following, such a component is referred to as a visual lightweight component. 
15 Such a graphic interaction may comprise drawing visual contents on the client 112A, for example, on a screen of a 
client laptop. Again, as described above, the main part of the processing is burdened on the runtime environment 
component residing and running on the server 111. 

[0342] The protocol which may be used for transmitting graphical requests between the client 11 2A and the server 
111 is the Remote Visualization Process protocol (RVP). RVP is a high level definition of a graphic device defined as 

20 a set of Interfaces. RVP is based completely on a component infrastructure. This gives RVP the ability to map func- 
tionality which a client system is unable to support, to a service component on the server side emulating this functionality. 
[0343] The graphical environment may communicate with the lightweight component 1 21 0 through the Java Abstract 
Window Toolkit layer (AWT). AWT stands for the definition of the graphic and user interface layer for the Java language. 
It is defined as a set of Java classes and interfaces which are mapped to the concrete Implementation on different 

25 platforms. AWT is part of the standard Java environment. 

[0344] The service component on the server side uses a VCL Implementation as drawing engine. VCL (Visual Class 
Library) Is a C++ class library . It provides similar to the AWT a set of classes and interfaces to build graphical appli- 
cations on different platforms. For every platform there is a concrete implementation of VCL. For the lightweight visual 
components, VCL provides a special implementation, which transmits ail graphical requests for drawing over the net- 

30 work to a client side, where these requests are Intercepted and mapped to a platform dependent graphic layer, which 
Is here AWT. 

[0345] Again, the implementation framework on the server handles drawing and user interaction transparently to the 
component. 

[0346] Fig. 1 5 illustrates RVP event processing. The visual lightweight component 121 0 is embedded In a graphical 
35 environment, the graphical environment comprising a display software program 1250 with a graphical user interface 
(GUI). The graphical user interface is referred to as a panel. An example of an implementation is a Java bean which 
is embedded in an HTML page and rendered by a browser. This Java bean represents a view (in a vwndow) of an office 
application component (e.g. StarOffice Writer) or another visual office component. 

[0347] An event from the graphical environment is passed to the AWT 1 260, and then interpreted by the RVP protocol 
40 layer, which performs communication between the client visual lightweight component 1210 and the remote office 
runtime environment component implementation 1110 on the server platform 111. From RVP 1220 the event is mar- 
shaled by communication component 1 200 and transmitted to the server 111. There, it is unmarshaled and passed to 
the RVP 1120 by communication component 1100, and dispatched by the VCL layer 1140. 

[0348] The runtime environment component 1110 receives the event After the event is dispatched, the component 

45 11 1 0 is able to react to the event. 

[0349] Fig. 16 illustrates the transmission of the response of the component 1110 on the server 111 back to the 
requesting client 11 2A. The requested service is here a drawing functionality which is implemented by RVP drawing. 
The office component (e.g. the StarOffice Writer) 1 1 1 0 is able to draw on a panel within software program 1 250 of the 
client 112A using the same mechanism as described above. The component 1110 uses the VCL 1140 as a drawing 

50 engine. The operations are transmitted through VCL 1140, RVP 1120 and communication component 1100 on the 
server 111 to the client 112A. Client 112A receives the operations and passes them to the AWT 1260 which is able to 
draw on the panel of the client 11 2A directly. 

[0350] Fig. 1 7 illustrates accessing an API as a runtime environment component on the server 1 1 1 by the client 1 1 2A. 
The visual lightweight component 1210 is, in the example described in Fig. 15 and Fig. 16, still able to access trans- 
55 parently the full functionality of an API 1104 provided by the office component 1110. The request of the lightweight 
component 1210 for API 1104 is handed over to the office component 1110 through the communication component 
1200 on the client 112A and the communication component 1100 of the server 111 . Herein, the request for the API 
1104 generated by the lightweight component 1210 may bypass RVP 1220 and AWT 1260 on the client 112A and 
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likewise RVP 1120 and VCL 1140 on the server 111 , if not drawing services are requested. The latter would be the 
case, for example, if AP1 1104 would provide calculation services. In order to have the request bypass the mentioned 
components the lightweight component 1210 must decide that these components shall be bypassed. This decision 
can be made by the lightweight component 1 21 0 based on the call of the AP1 1 1 04 received from the software program 
5 1 250 and the information that the AP1 1 1 04 does not provide drawing services. This information will regularly be present 
in the lightweight component 1 21 0, since it has information about all runtime environment components being available 
on the server 111 anyway, since it has to request their services and receive their responses. However, If necessary 
the office component 1110 may also react to the request for AP1 1104 by drawing via RVP 1220 directly on the panel 
of client 11 2A. 

10 [0351] An exemplary scenario for the latter might be the following: a user on client 112A editing a text document 
displayed in his browser whishes to change the font size to 1 0 points throughout the whole document. For this purpose, 
the client 11 2A uses the AP1 1104 to change ail fonts throughout the whole document to a size of 10 points. In this 
case, the office component 1110 njnning on the server 111 re-calculates the display of the document, renders the 
document remotely, and draws the document on the client 112A through the RVP 1120 and RVP 1220. 

15 [0352] However, if the user on client 1 1 2A changes the font size only for newly input text lines, the currently displayed 
document does not change, thus there is no need to re-draw the whole document on the client 112A. The event of 
changing the font size is passed via RVP 1 1 20 to the office component 1 1 04 and forces new rendering of the document 
on the server 111. Since no re-drawing of the document on the client 1 1 2A Is needed, the lightweight component 1 21 0 
does not have to take any further action. 

20 [0353] The participating components to create a Java bean lightweight component in the frame of the office appli- 
cation program package StarOffice used as a runtime environment component are shown in Fig. 18. An accompanying 
sequence diagram is supplied in Fig. 19. The figures are reduced to show only needed relations and methods to 
illustrate this specific process. A StarOfficeBean represents a common java bean which is derived from a java panel. 
It resides on the client as the single instance Connector, which Is responsible for maintaining connections to the remote 

25 machine. All client beans share one connection per user and server. The OCIientFactory created by the Connector \s 
also located at the client 112A. This enables the remote Office Component to create elements which are specific to 
the client 11 2A. Examples for these items range from a simple frame window to a printer device handled locally. Next 
the Con/?ector establishes a connection to the remote machine and starts the login process. If succeeded the server 
111 starts a StarOffice session remotely and the Connector confirms the session with StartQ. The task of the remote 

30 MultiServiceFactory created by the RVP Connection instance is to create needed instances on the remote machine. 
Then a local ORmFrameWindow 'xs created and passed together with a reference of the OCIientFactory to the remote 
StarOffice instance to be able for local dispatching and drawing. By calling initialize() on the remotely created Java 
Bean Frame all actions are done and the process of creating a StarOfficeBean is completed. 
[0354] Unlike components like CORBA objects, lightweight components 1210 do not have any additional code for 

35 accessing the implementing object. Also the size of a lightweight component 1210 does not increase with the number 
of accessed runtime environment components of the implementation server framework. This introduces the ability to 
offer components which expose only services designed for a special purpose and hide complexity of the implementation 
framework. 

[0355] By applying the invention, it is possible to include for example full word processing functionality provided by 
40 the server 1 1 1 into any other application program 1 250 running on the client computer 11 2A. 

[0356] Special purposes may be applications designed for being executed on particular clients like handheld com- 
puters or mobile telephones, where storage and processing capabilities are particularly limited. Nevertheless, the whole 
functionality of the framework is still accessible. 

[0357] Furthermore, when adding new runtime environment components to the sen/er 111, no modification on the 
45 client side is necessary. Through the concept of lightweight components, a new runtime environment component on 
the server is immediately callable by the client. The components are based on a generic lightweight component which 
is able to communicate with the implementation framework via the object component model. 
[0358] Fig. 20 refers to an example for using the present invention. In this example a setup is used as described in 
Fig. 15 to 17. Therefore, reference numerals also relate to components which are presented and described In more 
50 detail in connection with Fig. 1 5 to 1 7. However, the method according to Fig. 20 does not correspond to the methods 
described along Fig. 15 to 17. 

[0359] In this example, a user utilizes his computer system as a client 112A. This client 112A includes a screen on 
which the user can edit and process a text document. The client 112A Includes text processing software 1250 with a 
limited scope of functionality and a lightweight component 1 21 0 which corresponds to comprehensive services offered 
55 by an office suite software package 1110 located as runtime environment components on a server 111 to which the 
client 112A is connected via a network 113. 

[0360] For the purposes of this example the user edits a text document on the screen of the client 1 1 2A and changes 
the font size of the text. In order to do this he inputs his conrimands via a suitable input device of the client 112A, for 
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example, a keyboard. In step 2010 the text processing software 1250 on the client 112A requests the service "font 
change" from the lightweight component 1210. The lightweight component 1210 receives this request in step 2020. In 
step 2030 the lightweight component 1210 marshals the request and transmits it via the communication component 
1200 in client 112A to the communication component 1100 of the sen/er 111 via the network 113. 

5 [0361] The server 111 unmarshals the request and calls the runtime environment component 1110 in step 2040. In 
the next step 2050 the component 1110 starts processing the "font change" request. It will determine In step 2060 if a 
re-drawing of the text document on the screen of the client 112A is necessary due to the requested font change. 
[0362] If not. the service component 1110 will Immediately produce a result to the request in step 2080. A re-drawing 
may not be necessary, If the user wants the font change to be effective exclusively for further input into the text docu- 

10 rnent. In this case the result to be provided by component 1110 could be a return code to the software program 1250 
which tells the software program 1250 that further input into the text document will be processed with the new font on 
the screen of the client 112A. 

[0363] If yes, for example, if the font shall be changed for the whole text document, the component 1110 renders a 
new graphical presentation of the text document in step 2061 . Then, in step 2062, the output operations for the reali- 

15 zation of the graphical presentation are given to the VCL 1140 by the component 1110. In step 2063 it will be decided 
by VCL 1140 whether the output operations have to be carried out in a visible area, e.g. on a screen. 
[0364] If this is not the case, for example, if the text document with the font changed throughout its entire scope 
would only be stored as a data file but not shown on the screen of the client 1 1 2A, the result would be created in step 
2090 by VCL 11 40. This result would be the text document in the new form. No display on the screen of the client 1 1 2A 

20 would be envisaged in this case. 

[0365] If this is the case, for example, if the text document shall be displayed on the screen of the client 11 2A, the 
"change font" request realized by VCL 1140 is transmitted to RVP 1120 in step 2064. This realized request is then, in 
step 2065, marshaled and sent via communication component 1100 of server 111, via the network 113 and via the 
communication component 1 200 of the client 1 1 2A to the lightweight component 1 21 0 on the client 1 1 2A. In step 2066 

25 the lightweight component 1 21 0 unmarshals the realized request. In step 2067 the request is translated into an AWT 
request. This AWT request is transmitted in step 2068 from the lightweight component 1210 via the RVP 1220 to the 
AWT 1 260. In step 2069 the AWT 1 260 executes the transmitted AWT request. Finally, in step 2070 the result will be 
transmitted to the software program 1 250 so that the text document will be drawn on the screen of the client 11 2A with 
the new font size. 

30 [0366] Fig. 21 illustrates a non-visual lightweight component. Non-visual means that the user of the client on which 
the lightweight component is located does not receive any hints as to its presence. He does not see it and he can also 
not interact with it directly. 

[0367] In Fig. 21 a client 2110 is shown with a screen showing, on the left, a tree-like representation of data files 
below a window, and, on the right, information given about a certain text document which was selected by the user by 
35 means of the tree-like representation of data files. The client 2110 is connected via network 2120 to a server 2130 
which has access to a text processing software program as runtime environment component 21 40. This component 
2140 has in turn access to a storage medium 2150 and to a library 2160. 

[0368] If a user of the client 2110 wants to obtain information, for example, number of words and lines, author and 
date of this version, about a text document chosen from the tree-like representation of data files, he enters his request 

40 via an input device of the client 2110, for example, a keyboard of the client 2110. Then, the non-visual lightweight 
component on the client 21 1 0 will contact, as described above, via the network 21 20 the server 21 30 and ask for the 
services providing the information requested by the user from the runtime environment component 2140. The result 
provided by the component 21 40 will then be re-transmitted to the client 21 1 0 so that the desired information - number 
of words and lines; author and date of this version of the selected text document - can be displayed on the screen of 

45 the client 21 1 0. The lightweight component remains non-visual to the user of the client 211 0. 

Fig. 22 in contrast shows an example of a visual lightweight component, that means a lightweight component with 
which the user may interact, but which will at least be recognized by the user in some situations. 
[0369] A client 2210 Includes a visual lightweight component. The client 2210 is connected via network 2220 with 
the server 2230, which in turn has access to the runtime environment component 2240 connected to storage medium 

50 2250 and data base 2260. 

[0370] In this example, a user of the client 221 0 edits a text document on the screen of the client 221 0, as shown in 
Fig. 22 on the right, besides the above described window and tree-like representation of data files. The shown screen 
representation of the text document shows in the right middle position a small window with which the user may ma- 
nipulate the displayed text document. This window represents the lightweight component. Here, the user may directly 

55 . interact, via the window presentation, with the lightweight component, which is therefore referred to as a visual light- 
weight component. 

[0371] If the lightweight component is activated by a user interaction it may contact, as described above, the server 
2230 and thereby the mntime environment 2240, which may provide a service requested by the user by his interaction 
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from the client 2210. 

[0372] Comparing a non-visual and a visual lightweight component as above described, it may be advantageous to 
use a non-visual lightweight component for processing requests which do not require particular operations for their 
fulfillment, In particular, no drawing operations on a screen of a client. In this case, the non-visual lightweight component 

s may provide the response to the request more quickly than a visual lightweight component, since, for example, drawing 
operations are not processed at all; they are not only ignored by the client after having been processed with great efforts. 
[0373] In the following, further embodiments will be described with respect to Figs. 23 - 36. 
[0374] The following embodiments enable a first software program using a first binary specification to employ a 
limited functionality of a second software program using a second binary specification. 

10 [0375] Many software programs, which are created in different programming languages, have to communicate with 
each other. For example, a first software program created in a first programming language is able to provide tables. It 
calls another software program created in a second programming language which is able to calculate figures which 
are needed in the table to be produced by the first program. The calculation program cannot be called by the table 
program, since these two programs use different binary specifications for the communication because of their different 

15 programming languages. The different binary specification can be caused by different programming languages as well 
as by different compilers for the same programming language, since the communication problems caused by a different 
programming language and by different compilers for the same programming language are comparable, if not identical. 
[0376] The prior art solution to this problem is to provide transformer modules for each required transformation route, 
for example from a certain first binary specification to a certain second binary specification. Since In modern computer 

20 applications many different software programs may be called by a certain sofhware program, the computer system 
requires a voluminous library of transformer modules. This extensive library needs significant storage space and regular 
maintenance, since for every new binary specification which shall be accessible a full new set of transformer modules 
must be provided, in addition to the existing transformer modules. However, most of these transformer modules are 
not used frequently, so that their storage is not efficient. 

25 [0377] Furthermore, these prior art transformer modules extend to the full functionality of the software program to 
be translated from one binary specification to another. Due to the regularly wide functionality of software programs 
known transformer modules are rather voluminous and require, when they are activated, a signif icant amount of working 
memory and processor time from the computer system on which they are carried out. Furthemnore, the complete 
translation of a software program is burdensome and time consuming, although it Is in most cases unnecessary for 

30 the specific task to be accomplished. 

[0378] Thus, It is desired to provide an efficient method to enable a first software program to employ certain func- 
tionalities of a second software program, wherein the first and the second software program use different binary spec- 
ifications. 

[0379] A first software program using a first binary specification may employ a limited functionality of a second soft- 
35 ware program using a second binary specification with the following steps: 

a) initiating the creation of a stub, which is able to transform commands relating to the limited functionality of the 
second program between the second binary specification and an intermediate binary specification, using a second 
bridge, wherein the second bridge provides a mapping of the second binary specification and the intermediate 

40 binary specification, 

b) initiating the creation of a proxy, which is able to transform commands relating to the limited functionality of the 
second program between the first binary specification and the intemiediate binary specification, using a first bridge, 
wherein the first bridge provides a mapping of the first binary specification and the intemiediate binary specification, 

45 and 

c) Initiating the arrangement of the proxy and the stub relatively to the first program and the second program in a 
manner allowing the first program to employ the limited functionality of the second program. 

50 [0380] Software programs generally are compiled executable programs. Software programs are initially written in a 
programming language, for example, C++ or Java or an object model like Corba. They are compiled with compilers 
corresponding to the programming language. However, for each programming language several compilers may be 
available. The binary specification In which a software program is able to communicate with other software programs 
depends on both, the programming language and the compiler. This communication language of a software program 

55 is the language referred herein as the binary specification used by a software program, for example, the first, the 
second and the intermediate binary specification. 

[0381 ] The intermediate binary specification serves as the binary specification into and from which the communication 
between the first and the second software program will be translated. This intermediate binary specification may be, 
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for example, an existing binary specification like the binary specification of a specific compiler, but it is also possible 
that this intermediate binary specification is a suitable newly created binary specification, for example, a binary spec- 
ification which facilitates translation into and from it. 

[0382] According to the following embodiments the two transformer modules, called proxy and stub, may be created 
5 on demand, that means if and when they are needed. This creation on demand will be initiated directly that means by 
the first software program or by means of an initiating function. This creation on demand Is considered to be dynamic, 
so that the commands of the first software program may be dispatched dynamically. The two transformer modules are 
at least able to transform commands corresponding to a limited functionality of the second software program. Since 
the first software program employs in most cases only a part of the functionality of the second software program, the 
10 two transformer modules need to transform only commands which correspond to this limited functionality. Here, com- 
mands may be any kind of message initiating any kind of activity of a software program and which may be transmitted 
between the two software programs. 

[0383] It is possible to insert further modules between these two transformer modules. These modules may be able 
to Intercept the commands. This interception may be used, for example, to add security or accounting functionality. It 

IS is also possible to use these two transformer modules to synchronize the commands or to use them for debugging. 
[0384] For the creation of the proxy and the stub mappings between the basic commands, on which all other com- 
mands are based, of the two pairs of participating binary specifications are used. These pairs are the first binary spec- 
ification and the intermediate binary specification and the second binary specification and the intermediate binary 
specification. These mappings will be provided by the bridges and may be, for example, stored in a data base. However, 

20 the bridges may also already be a part of the second software program. In case these mappings cover the complete 
functionality of the relevant binary specifications - which Is frequently the case - only some parts of the mapping may 
be considered during the creation of the proxy and the stub, since they relate to the above mentioned limited functionality 
only. 

[0385] After their creation the proxy and the stub are arranged in a manner which enables the first software program 
25 to communicate with the second software program. That means a path of communication must be arranged from the 
first software program to the proxy, from the proxy to the stub, and finally from the stub to the second software program. 
This route must regularly be accessible from both sides, that means from the side of the first software program as well 
as from the side of the second software program. 

[0386] In order to generate the stub the second binary specification used by the second software program must be 
30 known. For this purpose, the first software program may start the second software program. This may be done by the ■ 
first program by means of a loader function which loads the second software program. Loader functions are well known 
In the prior art. A loader function is able to initiate a software program using a certain binary specification on demand 
of another software program using a different binary specification. The loader function may directly initiate the creation 
of the required stub or it may initiate that the second software program or an auxiliary program communicating with 
35 the second software program creates the stub. This is possible, If the loader function carries or supplies by any means 
the information about the limited functionality of the second software program requested by the first software program. 
[0387] The creation of the stub may be carried out by the second software program or by any sub-program of the 
second software program. It is possible that this sub-program exists already in the second software program. However, 
this sub-program may as well be procured or generated by the second software program in response to a request of 
40 the first software. 

[0388] After the creation of the stub, the initiated second software program or its sub-program creating the stub may 

infonn the first software program that the stub has been created. This may initiate the creation of the proxy by the first 

software program or any suitable sub-program, as It was described above for the creation of the stub. 

[0389] The proxy may be created by the first software program or a sub-program, a function thereof. The sub-program 
45 of the first software program must consider the bridge for the transformation of the first binary specification into the 

intermediate binary specification and reverse and the requested limited functionality of the second software program. 

The information about the requested limited functionality is generally available in the first software program, because 

the first software program requests this limited functionality from the second software program. 

[0390] In order to enable the communication between the first software program and the second software program 
so the stub and the proxy may transform any commands or other messages between these two software programs, as 

far as the proxy and the stub support this functionality. This requires the above described arrangement of the proxy 

and the stub relatively to the first and the second software program. 

[0391] A method for employing a limited functionality of a second software program using a second binary specifi- 
cation by a first software program using a first binary specification may Include the following steps: 

55 

a) initializing the limited functionality of the second software program by the first software program, 

b) creating a stub, which is able to transfonm commands relating to the limited functionality of the second software 
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program between the second binary specification and an intermediate binary specification, using a second bridge, 
wherein the second bridge provides a mapping of the second binary specification and the intermediate binary 
specification, 

5 c) creating a proxy, which is able to transform commands relating to the limited functionality of the second software 

program between the first binary specification and the intermediate binary specification, using a first bridge, wherein 
the first bridge provides a mapping of the first binary specification and the intermediate binary specification, 

d) transmitting an command relating to the limited functionality from the first software program to the proxy, 

10 

e) transforming the command from the first binary specification into the intermediate binary specification by the 
proxy. 

f) transmitting the command transformed by the proxy from the proxy to the stub, 

IS 

g) transforming the transmitted command from the intermediate binary specification into the second binary spec- 
ification by the stub, 

h) transmitting the command transfonned by the stub from the stub to the second software program, 

20 

I) carrying out the command in the second software program and generating a response for the first software 
program, 

j) transmitting the response, being in the second binary specification, from the second software program to the stub, 

2S 

k) transfomiing the response.from the second binary specification into the intermediate binary specification by the 
stub, 

I) transmitting the response transformed by the stub from the stub to the proxy, 

30 

m) transforming the response from the intemriediate binary specification Into the first binary specification by the 
proxy, 

n) transmitting the response transformed by the proxy from the proxy to the first software program. 

35 

[0392] The transmissions between the proxy and the stub and the software programs and the proxy or the stub, 
respectively, may be effected by any suitable means. It is relevant, however, that these elements are arranged so as 
to allow the communication of the two software programs. 

[0393] Furthemnore, a method for using a stub, which is able to transform commands relating to a limited functionality 
40 of a second software program between a second binary specification and an intennediate binary specification, using 
a second bridge, wherein the second bridge provides a mapping of the second binary specification and the intermediate 
binary specification, Is provided for enabling a first software program using a first binary specification to employ the 
limited functionality of the second software program by further using a proxy, which is able to transform commands 
relating to the limited functionality of the second software program between the first binary specification and the inter- 
45 mediate binary specification, using a first bridge, wherein the first bridge provides a mapping of the first binary speci- 
fication and the intermediate binary specification, wherein the proxy and the stub are arranged relatively to the first 
software program and the second software program in a manner allowing the first software program to employ the 
limited functionality of the second software program. 

[0394] A method for using a proxy may enable to transform commands relating to the limited functionality of the 
50 second software program between the first binary specification and the intermediate binary specification, using a first 
bridge, wherein the first bridge provides a mapping of the first binary specification and the intermediate binary speci- 
fication, for enabling a first software program using a first binary specification to employ the limited functionality of the 
second software program by further using a stub, which is able to transform commands relating to a limited functionality 
of a second software program between a second binary specification and an intermediate binary specification, using 
55 a second bridge, wherein the second bridge provides a mapping of the second binary specification and the intermediate 
binary specification, wherein the proxy and the stub are arranged relatively to the first software program and the second 
software program in a manner allowing the first software program to employ the limited functionality of the second 
software program. 
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[0395] A computer program, also referred to as a computer program product, may carry out the above operations. 
A computer program product comprises a medium configured to store or transport computer readable code, or in which 
computer readable code may be embedded. Some examples of computer program product are: CD-ROM disks, ROM- 
cards, floppy disks, magnetic tapes, computer hard drives, sen/ers on a network and carrier waves and digital signals 

5 transmitted over a telecommunication link or network connection. 

[0396] Such computer program may be stored on any data carrier, such as, for example, a disk, a CD or a hard disk 
of a computer system. It is further provided a method for using a computer system, including standard computer sys- 
tems, for carrying out the present Inventive method. Finally, a computer system may comprise a storage medium on 
which a computer program for carrying out the above operations may be stored. 

10 [0397] Following, reference is made to Fig. 23. A first software program 2301 , created with any convenient program- 
ming language, for example C++, and compiled with a certain compiler for C++, uses a first binary specification. This 
first binary specification depends on both, the programming language and on the compiler. The first software program 
2301 may be. for example, able to present numbers in graphical form. In order to calculate the exact dimensions of 
the graphs the first software program 2301 may want to employ a second software program 2302. created with another 

15 programming language, for example Java, and compiled by using a certain compiler for Java. This second software 
program 2302 uses the second binary specification for communication. 

[0398] The use of the second software program 2302 by the first software program 2301 requires its initialization, 
for example, by calling a loader function 2305. The second software program 2302 may then initialize its sub-program 
2302a for creating the stub 2304. The sub-program 2302a must consider the limited functionality in order to arrive at 
20 the desired stub 2304, namely a module for transforming commands and responses relating to the requested limited 
functionality. Based on this limited functionality, the sub-program 2302a selects the relevant mappings of the bridge 
2307 between the second binary specification and the Intermediate binary specification. 

[0399] The first software program 2301 may correspondingly initiate a sub-program 2301 a to create the proxy 2303 
in a similar way, by employing the bridge 2306 between the first binary specification and the intermediate binary spec- 
25 iflcation. This sub-program 2301 a may be informed about the limited functionality from the first software program 2301 . 
However, it may also know this limited functionality from the second software program 2302 by communicating via the 
communication channel 2308. This channel 2308 may be any suitable real or virtual connection which allows the 
transfer of data. 

[0400] After the stub 2304 and proxy 2303 have been created they are arranged so as to allow the communication 
30 between the first software program 2301 and the second software program 2302. Once this arrangement Is effected 
the first software program 2301 sends the command to be transformed to the proxy 2303. The proxy 2303 may transfonn 
this command from the first binary specification into the intermediate binary specification. This Intemiediate binary 
specification corresponds, for example, to the binary UNO specification. The proxy 2303 may transmit this command 
in the intermediate binary specification to the stub 2304. The stub 2304 may transform the command from the inter- 
35 mediate binary specification into the second binary specification and may transmit the command then to the second 
software program 2302. 

[0401 ] The second software program 2302 may execute the command, for example, the command to calculate the 
dimensions of a graph and may generate a response for the first software program 2301 . This response may be trans- 
formed and transmitted by the stub 2304 and the proxy 2303 from the second software program 2302 to the first 

40 software program 2301 , 

[0402] The arrows shown in Fig. 23 between the first software program 2301 , the proxy 2303, the stub 2304, the 
second software program 2302 and the loader function 2305 show the possible routes of communication. The arrows 
between the proxy 2303 and the bridge 2306 and between the stub 2304 and the bridge 2307 represent the contribution 
of the bridges 2306 and 2307 to the creation of the proxy 2303 and the stub 2304, respectively. 

45 [0403] Fig. 24 represents an example for the initial communication of a first software program 2301 and a second 
software program 2302. The initial communication between the two software programs 2301 , 2302 is carried out, before 
the creation of the stub 2304 and of the proxy 2303 is initiated. Due to the different binary specifications used by the 
two software programs 2301 , 2302, namely the first and the second binary specification, this initial communication will 
regulariy be extremely limited. It may be effected as explained exemplary In the following. 

50 [0404] In a first step 2400 the first software program 2301 may call a loader function 2305 for the second software 
program 2302. The loader function 2305 may be any known loader function for this second software program 2302. A 
loader function for a program is a software module which "wakes up" this program so that it carries out certain functions. 
' Herein, the loader function may be addressed In one binary specification and may wake up a program using a different 
binary specification. However, the loader function is not suited to provide any detailed communication between pro- 

55 grams using different binary specifications. 

[0405] The loader function 2305 may be used by the first software program 2301 from the beginning. This is the 
case, if the first software program 2301 knows or assumes that the second software program 2302 does not use the 
same binary specification as Itself, namely the first binary specification. If this knowledge is not present in the first 
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software program 2301 , it may simply try to call the second software program assuming that it will understand the first 
binary specification. In this case, the first software program 2301 may only employ the loader function 2305 if the direct 
communication with the second software program 2302 fails and a corresponding message is returned to the first 
software program 2301 . 

5 [0406] In the calling step 2400 the first software program 2301 informs the loader function 2305 about the limited 
functionality requested from the second software program 2302. Therefore, the loader function 2305 must be suited 
to receive and carry this information. In order to provide this Information to the loader function 2305 the first software 
program 2301 may hand over to the loader function 2305 the command to be earned out by the second software 
program 2302, so that the second software program 2302 may, on receipt of the call of the loader function 2305 decide 

10 itself which functionality is needed, or the first software program 2301 may provide the loader function 2305 directly 
with the description of a limited functionality of the second software program 2302 which will be required by the first 
software program 2301 . 

[0407] In step 2401 the loader function 2305 contacts and initializes a reception function of the second software 
program 2302 to be able to transmit in the next step 2402 its information about the limited functionality required from 

15 the second software program 2302. In the next step 2403 the second software program 2302 analyses the information 
received from the loader function 2305 regarding the required limited functionality. After the analysis of the limited 
functionality required the second software program 2302 initializes the creation of a stub 2304. 
[0408] Fig. 25 shows the creation of a stub 2304. The stub 2304 has the task to transform commands sent by first 
software program 2301 to the second software program 2302 from the intermediate binary specification into the second 

20 binary specif ication used by the second software program 2302 and to transform responses sent by the second software 
program 2302 back to the first software program 2301 from the second binary specification into the intermediate binary 
specification. Furthermore, the stub 2304 may be assigned the task to transmit the transformed commands or respons- 
es to the recipients, the second software program 2302 or the proxy 2303, respectively 

[0409] In step 2500 the second software program 2302 may Initialize a sub-program 2302a for creating the stub 
25 2304. This sub-program 2302a may be an integral part of the second software program 2302 or it may be as well a 
separate independent software module which can be used by this and potentially any other second software program 
2302. Accordingly, the sub-program 2302a may be stored on the computer system or storage device on which the 
second software program 2302 is stored. However, the sub-program 2302a may also be stored on another computer 
system or storage device to which the second software program 2302 has access. 
30 [0410] In step 2501 the sub-program 2302a receives from the second software program 2302 a description of the 
limited functionality required from the second software program 2302. Then, in step 2502 the bridge 2307 between the 
second binary specification used by the second software program 2302 and the intermediate binary specification is 
contacted. This bridge 2307 provides a mapping of at least all basic commands between the mentioned two binary 
specifications. It may be stored at any place accessible for the sub-program 2302a. In many cases there may exist a 
35 library with bridges for a number of second binary specifications, assuming that the intermediate binary specification 
used would be the same for all intended operations. 

[041 1 ] From the selected bridge 2307 the sub-program 2302a chooses in step 2503 the mappings necessary to use 
the required limited functionality of the second software program 2302. This means all transformations, but not more 
than these, must be selected which are required to transform commands and responses which could arise when using 
40 the relevant functionality. Finally, in step 2504 the sub-program 2302a creates the stub 2304 based on the chosen 
mappings. 

[041 2] Fig. 26 represents in the form of a flow chart the creation of the proxy 2303. The proxy 2303 has the task to 
transform commands and responses between the first binary specification and the intermediate binary specification. 
It is insofar similar to the stub 2304 which has. as it was described above, the task to render these transfonnations 

45 between the second binary specification and the intennediate binary specification. 

[041 3] In step 2600 the first software program 2301 may initialize a sub-program 2301 a for creating the proxy 2303. 
This sub-program may be an integral part of the first software program 2301, but may as well be separate and inde- 
pendent from it. The sub-program 2301a may be accessible for a larger number of first software programs 2301. In 
step 2601 the sub-program 2301a receives from the first software program 2301 information regarding the limited 

50 functionality required from the second software program 2302. This information may be provided by passing on the 
actual command the first software program 2301 plans to send to the second software program 2302. so that the sub- 
program 2301a may derive from this command the information about the limited functionality, or the first software 
program 2301 may provide the sub-program 2301a with a description of the limited functionality. 
[041 4] In an alternative embodiment the description of the limited functionality may be received from the sub-program 

55 2302a for creating the stub 2304. The sub-program 2302a has the required description, because It has to create the 
stub 2304 according to the same description. The description may be exchanged between the sub-program 2302a 
and the sub-program 2301a by any suitable means of communication. 

[041 5] In yet an alternative embodiment the description of the limited functionality of the second software program 
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2302 may be derived directly by mapping the stub 2304 into the first binary specification, in order to create a proxy. 
This Is possible, because the stub 2304 reflects the required limited functionality in listings between the second binary 
specification and the intermediate binary specification which are necessary for the transformation of commands and 
responses. Therefore, the intermediate binary specification side of the listings of the stub 2304 may be taken as the 

5 starting point for the creation of the proxy 2303, which is completed by adding the corresponding parts of the listing in 
the first binary specification, as will be explained below. 

[041 6] In step 2602 the sub-program 2301 a contacts the bridge 2306, which provides a mapping of basic commands 
of the first binary specification and the intermediate binary specification, and builds, in step 2603, the desired proxy 
2303. 

10 [041 7] The proxy 2303 and stub 2304 are then arranged to allow the desired communication between the first soft- 
ware program 2301 and the second software program 2302. as it will be described in the following along the flow chart 
of Fig. 27. The arrangement of proxy 2303 and stub 2304 requires that the path of exchanging transformed commands 
and responses between the proxy 2303 and the stub 2304 is defined. 

[041 8] Therefore, In step 2700 the second software program 2302 Infonns the first software program 2301 about the 
15 address information necessary to contact the stub 2304 via the communication line 2308. The communication line 
2308 may consist of a simple data line for transmitting binary address infomnation which can be understood from the 
first software program 2301 without being able to use the second binary specification in which the second software 
program 2302 communicates. 

[0419] The first software program 2301 provides, in step 2701 , the sub-program 2301a with this received address 
20 information, which, in step 2702, is passed on to the proxy 2303. The proxy 2303 then contacts, for the first time in 
step 2703. the stub 2304, the address of which is now known. In step 2703 the proxy 2303 will also transmit its own 
address information to the stub 2304, thereby allowing the stub 2304 to contact the proxy 2303. Herewith, the proxy 

2303 and the stub 2304 are arranged for communication, that means they can send and receive commands and 
responses to commands. This arranging step is also referred to as binding. 

25 [0420] Fig. 28 shows a computer system 2800. The computer system 2800 comprises an i-/o-interface 2801 , a central 
processing unit (CPU) 2802 and memory 2803. It is connected to an external memory 2804 on which mass data may 
be stored as well as software programs. Furthermore, the computer system 2800 is connected via the i-/o- interface 
2801 to an output device 2805, for example, a screen, and to an input device 2806, for example, a keyboard. 
[0421] The inventive method may be applied in the shown standard computer system. The first software program 

30 2301 and the second software program 2302 may be stored In the internal memory 2803 of the computer system 2800, 
as well as on its external memory 2804. It is also possible that one of the programs is stored on the internal memory 
2803 and the other is stored on the external memory 2804. The proxy 2303 and the stub 2304 may be created by 
means of the CPU 2802. 

[0422] The above method may also be implemented and used on more than one computer system, for example, in 

35 a network or in a client-sen/er system, as it Is shown exemplary In Fig. 29. 

[0423] Fig. 29 shows a client 2900 which is connected to a server 2901 . This connection may be a data line 2902, 
including any kind of permanent or temporary network, like, for example, the internet. It is understood that, instead of 
only one client, there may be a large number of clients connected to the server. The first software program 2301 may. 
for example, be stored on client 2900. while the second software program 2302 may be stored on server 2901 . The 

40 exchange of commands and responses may be effected via data line 2902. For example, the bridges 2306 and 2307, 
as well as any other potentially needed bridges may be stored in one or more libraries on the server 2901. The sub- 
programs 2301a and 2302a may also be stored on the server 2901 . In case the sub-program 2301a is needed the 
client 2900 may request from the sen/er 2901 Its transmission via data channel 2902. 

[0424] In the following further embodiment are described in more detail along Figures 30 to 33 and Tables 1 and 2. 

45 

Creation of stub and proxy: 

[0425] In response to a call of a first software program a proxy and a stub will be created in the so-called proxy 
factory and the stub factory, respectively. In order to create a proxy and a stub three tasks have to be carried out. First, 

50 the first software program using the first binary specification has to be enabled to communicate with to the second 
software program using the second binary specification. Second, the stub factory has to create a uno Jnterface imple- 
mentation considering the second binary specification based on the limited functionality which delivers all calls directed 
to the second software program to this second software program. This unojnterface is program code which is defined 
for the limited functionality. For the generation of the uno_interface implementation the stub factory employs information 

55 in the form of a type description. This uno interface implementation is also referred to as the stub. Third, the proxy 
factory has to create a unojnterface implementation for the first binary specification. The proxy factory generates its 
uno.interface implementation based on the information of the type description. This unojnterface Implementation is 
referred to as the proxy. 



113 



EP1 130 510 A2 



[0426] The knowledge of the type description is necessary to create the stub and the proxy, as described. This type 
description is the full description of the limited functionality, also called interface. It contains the information about the 
required limited functionality of the second software program which shall be used by the first software program. The 
type description may refer to different types shown in Table 1 . 



Table 1; 



10 



Type 
Byte 



Short 



UNO 
Signed 6 Bit 



jStgned 8 Bit 



~ |Siqned 8 Bit 



Signed 16 Bit 



|Signed16Bit 



^igned 16 Bit 



Ushort 



tJnsigned 16 Bit 



lUnsigned 16 Bit 



Si gned 



32 Bit 



ISigned 32 Bit 



(Signed 16 Bit 



.Ulong 



Unsigned 32 Bit 



Hyper Signed 64 Bit 



[Unsigned 32 Bit 



JSigned 32 Bit 



ISigned 64 Bit 



iSigned32Bit 



jSigned 64 Bit 



UhypBf Unsigned 64 Bit 



Unsigned 64 Bit 



Float 



Processor dependent: Intel, 
ISEE noat 



Sparc =JProcessor dependent: Intel. Sparc = '^^^iggE float 
float ■ 



DoutDle 



Processor dependent; Intel. 

IEEE double 



Sparc = 



Processor dependent Intel. Sparc = IEEE 

double 



Enum 



20 



25 



3D 



35 



40 



45 



The size of an machine word, 
this is the size of an integer. 



Normally|rhe size of an machine word. Normally 
this is the size of an integer. 



Boolean 1 Byte. 



1 Byte. 



jSigned 64 Bit 



IEEE double 



All enum values of one enum declaration 
are static object of a class. Each object 
contains a 32 bit value which represents 
fhe enumeration value^^ 



Boolean 



Char 



16 Bit on WNT. W95. W96. Os2. 32 Bt( 
on Unix 



16 Bit on WNT. W95. W9fi. Os2. 32 Bit on 
Unix 



Unsigned 16 bit (char) 



Stnng 



A pointer to a structure which have the 
following members: 
long refCounl, 
long length; 
vicharj buffer( 
The string in buffer is 0 terminated. This 
is the rtl_wString structure in the rtl 



brary 



(K pointer to a structure which have the 
following members 
long refCount; 
; long length; 
wcharj buffefl...]; 
The string In buffer is 0 terminated. This is 
" the rtl_wString structure in the rti-library 



.java.lang.String' 



Structure 



Union 



The structure contains the members in 
*ihe order of the declaration. The 
memory layout is described at 

beginning of this chapter. 



The stnjcture contains the members in the 
order of the declaration. The memory 
the layout is described al the beginning of this 
chapter. 



A dass wWch is derived from 
java.lang.ObjecT and contains the 
members in the specified order. 



The size is 4 + size of the largest type, 
in front of the union members are a 
long value (nSelect) which describes 
:he position of the valid member {0 is 
me first). 



The size is 4 + size of the largest type. In 
front of the union members are a long 
value (nSetect) which describe the position 
□f the valid member (0 is the first). 



Not specified yet 



A pointer to a structure which has the A 
following members: 
void ■ pElements; 

Sequence long nElements; 

long nRefCount;)ong 
Tne pElements are a memory area that 
contains nElements elements. 



pointer to a structure which has the 
following members; 
void ' ■ • p Elements; 

Jong nElements; 

nRefCount; 

The pElements are a memoiy area that 
contains nElements elements. 



It is a nomia) Java array. 



Exception Looks like a structure 



Looks tike a structure 



dass whi(^ is derived from 
java.lang.Exception'' and contains the 
members in the specified order. 



i 

Interface 



The interface is a pointer to a function 
table, which contains 3 functions. 



It is a pointer to a C«~*-Cla5$ which 

implemertts first the virtual methodsjlt is a normalJava interface. 
querylntertace, acquire and release. 



Any 



This is a structure that contains a 
pointer to a type description. The 
second member is a pointer to the 

value stored in the any 



This is a stnjcture that contains a 
to a type description. The second 
is a painter to the value stored in the any. 



dass which is derived from 
pointerUava.lang.Objecr. The members are a 
member dass, which describe the type of the value. 
A second member which is the value of the 
any. 



Void 



Mo memory representation 



No memory representation 



No memory representation 



50 



[0427] Many of these types are self-explaining and known in the art. Nevertheless, the most relevant types of the 
type description will be explained In more detail below. "Interlaces": All interfaces employed in connection with the 
present embodiment are derived from a Super-Interface. Each interface contains at least three methods. The two 
55 methods "acquire" and "release" are necessary to control the lifetime of the interface. The third method "querylntertace" 
is used to navigate between different Interfaces. A XInterface includes only these three methods. All other interfaces 
are derived from this XInterface. The methods and functionalities requested by the first software program will be part 
of the interface. 
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[0428] In Java, for example, interfaces are mapped to Java interfaces which could be normally implemented. The 
methods acquire and release are not mapped to the Java program since this methods do not exist in Java. The lifetime 
of the proxy, the stub and the relevant information in the second program will be controlled by a garbage collector. The 
programming language Java delivers basic types by value and non-basic types by reference. All calls are specified by 
5 value except interfaces. So in Java all non-basic types returned or delivered through out parameters are by value, 
which means that the implementation must copy it before return or deliver. 

[0429] In C++, for example, interfaces are mapped to pure virtual classes. In order to automatically control the lifetime 
of interfaces a template called "Reference" will be used. All return, parameter and member types are "References" (e. 
g.: Reference< XInterface >). The "Reference" acquires the interface when it is constructed and releases the interface 
10 when It is destructed. "Structure": A structure is a collection of elements. The type of each element is fixed and it cannot 
be changed. The number of elements Is fixed. 

[0430] "Exceptions": An exception is a program control construct beside the normal control flow. One major feature 
of exceptions is. that it is simpler to implement the error handling. Exceptions are similar to structures since they are 
also a collection of elements and each type of each element is fixed and cannot be changed and the number of elements 
15 is also fixed. An additional feature of exceptions Is that they can be thrown by a method. All exceptions which can be 
thrown by a method must be declared at the method, except for the called "RuntimeException" which always can occur. 
All exceptions must be derived from "Exception". If an exception is declared at a method it is allowed to throw all derived 
exceptions. The caller of a method must respond to this behavior. 

[0431] In Java, for example, all exceptions are derived from the "java.lang. Exception". The exceptions are declared 
20 at the methods. 

[0432] In C++, for example, the exceptions are generated as structures. An exception Is thrown as instance (e.g.: 
throw RuntimeExceptionO). At the other side the exception should be caught as reference (...catch(RuntimeException 
&){...}). 

[0433] "Union": A union contains one element. The declaration of a union specifies the possible types. 

25 [0434] "Array": An array contains any number of elements. The type of the elements is fixed and cannot be changed. 
"Any": An any contains one element. All types of elements are possible. An any contains a reference to the value and 
the type description of the type. With the type description the bridge can transform the value, if necessary. 
[0435] In Java the any is. for example, represented by the class "Any", which contains a class as type description 
and a "javaJang.Object". v^rtiich is the value. The basic types are wrapped to their proper classes. For example, a 

30 boolean value is an object of the class "java.Iang.BooIean", which contains the value. 

[0436] In C++ the any is represented through the class "Any". Each type generated by a C++ codemaker implements 
an function "getCppuType". This function is used to implement the template access operators "«=" and "»=". These 
operators insert and extract the value of the any 

[0437] "Sequence": A sequence Is a generic data type. It contains the number of elements and the elements. In Java 

35 the specification of an array fulfills this specification. This is not true for C++. The array in C++ does not contain the 
number of elements. It is not possible to retum a C++-array. e.g. Char[] getNameQ is not possible. It is difficult to 
manage the lifetime between the called and the caller, if only a pointer is returned. Therefore, in C++ a sequence is a 
template with the name "Sequence". The implementation contains a pointer to a structure wrtiich contains a pointer to 
the elements, the number of elements and the reference count. So it holds the binary specification. It is cheap to copy 

40 this sequence, because only the reference count is incremented. 

[0438] The type description may exist or it may be runtime created. Each existing type is stored in a type repository 
along with the corresponding type description. The types of the type description are accessible through the full name 
of each type in the type repository. For example, the full name of the type "Xinterface" may be "com.sun.star.Xinterface". 
[0439] In a type repository the types heeded for any type description are stored in any appropriate way. If the API 

45 (application program interface) of the type repository is c-style, it is directly, that means via a binary representation, 
accessible from many binary specifications and it is quickly transferable. Since the type description of each element 
may be used during the generic marshaling of a call, the access performance of the type repository API is critical. 
Therefore, it is useful to use c-style structures, which describe each type. In addition, there may be interfaces declared 
which specify the access to the type repository. The module of this interface is "com.sun.star.typelib". 

50 [0440] All functions or type declarations have the prefix "typelibj'. All elements are reference counted. All elements 
start vwth the structure "typelib„TypeDescription". It is possible to cast all descriptions to this type. The function typellb 
tvpedescription newlnterface will be used to create an interface description. The descriptions of structures, unions and 
sequences are created with the function type!ib_typedescription_new. The description of the base type is initially part 
of the type repository. The function to get a type description is typelib_typedescription_getByName. 

55 [0441] The Java API to the type repository is different for two reasons. First, Java cannot access the binary repre- 
sentation of the type descriptions directly. Second, the Java runtime system provides an API (core reflection) similar 
to the type repository API. Unfortunately, the features "unsigned", "oneway" and "out parameters" are missing in this 
API. For this reason, additional information is written into the classes. 
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[0442] The representation of the types depends on the hardware, the language and the operating systenri. The base 
type is swapped, for example, if the processor has little or big endian format. The size of the types may vary depending 
on the processor bus size. The alignment Is processor and bus dependent. The alignment of the data structure is 
defined through the following algorithm: 

Structure members are stored sequentially 
in the order in which they are declared. 
Every data object has an alignment 
requirement For structures, the 
requirement is the largest of its members. 
Every object is allocated an offset so that 
offset % alignment-requirement = 0 

[0443] If it is possible that the maximum alignment can be restricted (Microsoft C/C++ compiler. IBM C/C++ compiler) 
than the size maximum alignment is set to eight. Under this condition the alignment is set to min{ n, sizeof( item ) ). 
The size is round up to the largest integral base type. 

[0444] For the Microsoft and IBM C/C++ compiler the alignment of structure is set to eight using the "#pragma" 
statement. Table 1 shows the binary UNO, C++ and the Java types. 

[0445] In order to address the proxy factory to generate the proxy the first binary specification has to be denommated. 
This will be a string, because it is extensible and the risk of double names is low. Then a tool for selecting the desired 
bridge is called. The first parameter for this tool is the "first binary specification" and the second parameter is the 
intermediate binary specification "UNO". Then a function is called for selecting the desired mapping of the bridge. The 
name of the function is. in this example, "getMappIng Factory". A call to create a proxy in "objective c" will be "getMap- 
pingFactory("objective_c-. "uno")". The implementation of the function will search a shared library named 
"obiective_cuno' to find the right library that contains the proxy factory. In Java the tool may search for a class of name 

"objective_cuno". , * « * 

[0446] In order to create a stub merely the parameters of the function have to be changed, in our example to get- 
MappingFactoryCuno", "objective^c")". A stub implements the unojnterface. in the dispatch function the stub must 
call the right method of the original object. This is simpler in a programming language like Java, which has a "core 
reflection API", than in a programming language like C++, which has no binary standard and no API to call virtual 

methods. x- ^ • *u 

[0447] In creating a proxy the proxy factory must generate method code to implement each method specified in the 
interface to be created. The only information to do this is a type description of the interface. For example: In Java (1 .1 ) 
a binary class file (*.class) must be generated and loaded with the class loader, in the absence of a loader which can 
directly load binary classes a loader has to be provided. In C++ virtual method tables must be generated which delegate 
each call to the unojnterface. In the absence of a binary C++ specification individual compilers (version, switch....) 
may have to be explored in order to implement this. 

[0448] The proxy and the stub factory employ bridges for the generation of the proxy and the stub, respectively. A 

bridge implements Infrastructure to exchange interfaces between two environments and is bidirectional. 

[0449] An environment contains all objects which suffices the same specification and iies in the same process address 

space The environment is specific for a programming language and for a compiler. For example, an object resides in 

the -msci" environment, if it is implemented in C++ and compiled with the Microsoft Visual C++ compiler. It may also 

be session specific for some reason, e.g. when running multiple Java virtual machines in one process. In the latter 

case these virtual machines have to be distinguished. However, this case is not a common case. 

[0450] Regulariy, the environment is the area in which the same binary specification is employed. Therefore, the first 

software program and the second software program belong to different environments. 

[0451] Each bridge is implemented in a separate shared library. The name of the library is a connection of two 
environment names with an underscore ('J) between the names. Each bridge library exports two functions called 
"uno„ext_getMapping" and "uno initEnvironment". The first function is called to get the mappings. 
[0452] In order to get a mapping uno_getMapping() has to be called. There is also a C++ class called cppu.Brldge 
which can be used with the source and destination environment names. The uno ext getMapping () call then receives 
its source and destination environments. The bridge library cannot be unloaded while any code of it is still needed. So 
both mappings and any wrapped interface (proxy) that is exported needs to modify a shared library wide reference 
count. If the shared library can be unloaded the reference count goes to zero. 

[0453] The intention of an environment structure is to provide common functions like acquirelnterfaceQ and to know 
all proxy interfaces and their origins. This is specifically important because of the object identity of an interface. The 
proxy the stub and the second program are defined to provide the same iristance of the XInterface any time it is queried 
for it This is important to test, if two interfaces belong to the same object (e.g. testing the source of an incoming event). 
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[0454] When interfaces are mapped around some environments in space, they must provide the same XInterface 
in each environment (e.g. in C++, equal XInterface pointers). 

[0455] It is not recommended to only keep an eye on this object identity issue. It is well recommended to reuse any 
interface, i.e. rejecting the production of proxy interfaces as often as possible, because each constructed proxy interface 
leads to another indirection when called, and there will of course be many interfaces. 

[0456] So an environment knows each wrapped interface (proxy) running in it and the origin of each of these inter- 
faces. Table 2 shows the representation of an environment. 



Table 2: 

s truce uno_Environment 
( 

• a name for this environment 
rtl_String * pName; 

''"a free context pointer, that can be used for specific classes of 
environments, 

• e.g. a jvxci pointer 
*/ 

void * pContext; 
/*• 

* Acquires this environment. 
•'<BR> 

' eparam pAccess this access interface 

* =. » 

void (SAL_CALL ' acquire) I uno^Envxronment * pEnv j ; 
/** 

• Releases this environment; ^„„r-!n»a 

* last release of environment will revoke the environment from runtime. 

•<BR> 

* eparam pAccess this access interface 
*/ 

void (SAL^CALL * release) { uno_Environment * pEnv ) ; 

* Tests if two environments are equal,. 
♦<BR> 

• eparam pEnvl one environment 

* eparam pEnv2 another environment 

♦ / 

sal Bool (SAL CALL * equals) ( const uno_Environment * pEnvl. 
- ~ const uno_Environment * pEnv2 ) ; 

^*\ou register internal and external interfaces via this method. 

* Internal interfaces are proxies that are used in an environment . 

* External interfaces are interfaces that are exported to another 

* environment, thus providing an object identifier for this task. 

• This can be called an external reference. 

* interfaces are held weakly at an environment; they demana a final 

* revokelnterfaceOcall for each interface that has been registered. 
*<BR> 

♦ eparam pEnv this environment . ^ ^ i^*.^^^^^^ 

♦ eparam pplnterface inout parameter for the registered interface 

• eparam ppOId inout parameter for the corresponding object id 

♦ eparam pTypeDescr type description of interface 

♦ eparam acquire function to acquire an interface; 

* this function provides a boolean return 

♦ value to signal if the acquisition was successful tnecessary tor 

* proxy interfaces) 

• / 

void (SAL CALL * register Inter face) ( uno_Environment * pEnv, 
~ void ♦♦pplnterface, 

rtl string ** ppOId, 
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10 



pTypeDesct 



typelib_lnter£aceTypeDescriptxon 

uno_regAcquireFunc acquire ) ; 



* You have to revoke ANY interface that has been registered via this method. 
*<BR> 

♦ eparam pEnv this environment 

* eparam pOld object id of interface to be revoked 

♦ Gparam pTypeDescr type description of interface to be revoked 
*/ 

void (SAL_CALL ♦ revokelnterface) { uno_Environinent ♦ pEnv, 
rtl_String * pOld, 

typelib InterfaceTypeDescription * pTypeDescr ); 



15 



20 



* Retrieves an interface identified by its object id and type from 

* this environment. 
*<BR> 

* fiparam pEnv this environment 

* eparam pplnterface inout parameter for the registered interface; 

* (0) if none was found 

* eparam pOId object id of interface to be retrieved 

* eparam pTypeDescr type description of interface to be retrieved 
*/ 

void (SAL CALL * getRegisteredlnterf ace ) ( uno_Environment ♦ pEnv, • 
~ void ** pplnterface, 

rtl String * pOId, 

typelib InterfaceTypeDescription * pTypeDescr 



25 



30 



35 



found 



/** 

* Retrieves the object identifier for a registered interface from 

* this environment. 
*<BR> 

* gparam pEnv this environment 

' eparam ppOId inout parameter for object id of interface; (0) if none was 

* eparam pinterface a registered interface 

* eparam pTypeDescr type description of interface 
*/ 

void (SAL_CALL * getRegisteredObjectldentifier ) ( uno_Environment * pEnv, 

rti_String ** ppOId, 
void * pinterface, 

typelib InterfaceTypeDescription "* pTypeDescr 



Disposing callback function pointer that can be set to get signalled 



* the environment is destroyed. 
*<BR> 

* eparam pEnv environment that is being disposed 
-/ 

void (SAL CALL * environraentDisposing) ( uno_Environment * pEnv ); 



40 



45 



/** 

* Computes an object identifier for the given interface; is called by 

* the environment implementation. 

* <BR> 

* eparam pEnv corresponding environment 

* eparam ppOId out param: computed id 

* eparam pinterface an interface 
*/ 

void (SAL CALL ♦ computeObjectldentifier) ( uno_Environment * pEnv, 

- rtl String ** ppOId, void * pinterface ) ; 



50 



* Function to acquire an interface. 
*<BR> 

* eparam pEnv corresponding environment 

* eparam pinterface an interface 
*/ 

void (SAL CALL * acquirelnterf ace) ( uno_Environment 



pEnv, void * pinterface 



55 



* Function to release an interface, 
*<BR> 

* eparam pEnv corresponding environment 

* eparam pinterface an interface 
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void {SAL_CALL * releaselnterface) ( uno_Environment * pEnv, void * pinterface 

); 



[0457] Environments, as defined above, consist of several fields. The first fields are used for identifying the environ- 
ment, for specifying the hardware, the process, and maybe a session specific ID. There is also a context pointer which 
can be used for specific classes of environments, e.g. when It is known that there is a Java environment the virtual 
machine pointer can be stored there. 

[0458] In order to use environments, these environments regularly have to be registered. An existing environment 
may be obtained by calling uno^getEnvironmentQ. A new environment can be created by either implementing It directly 
or by using a simple default implementation, which is frequently also sufficient, by calling, in the given example, 
uno_createDefaultEnvironment() with the environment's name and its acquire and release function for interfaces. 
[0459] In order to improve the performance the bridges should use the shortest way between two environments. 
Especially, If there are programs instantiated in the Identical environment, the communication between them should 
be direct and not over a proxy and a stub. 

[0460] Mapping is the direct way to publish an Interface In another environment. That means an interface is mapped 
from a source environment to a target environment so that methods may be invoked on a mapped interface in the 
target environment which are delegated to the originating interface in the source environment A mapped interface 
may also be called a proxy or a stub. 

[0461] Mapping an Interface from an environment A to an environment B requires that several steps are performed: 
First, the origin of the Interface from environment A has to be retrieved (call getlnterface Origin () on environment A). 
For this purpose, the environment A looks into its proxy interfaces table to check If there is such an interface already 
known (pointer and type). If the answer is no, then this Interface must originally come from environment A, or else it 
must originate from any other environment and its origin must be known, since each proxy interface must have been 
registered with its origin. Second, an existing proxy interface has to be looked for in environment B with the same origin 
and type (call getlnterfaceQ on environment B). If a proxy interface of that origin and type is already in use in environment 
B, then this interface Is acquired, or else a new proxy has to be constructed wrapping the source interface from envi- 
ronment A. The fresh proxy interface Is then to be registered via registerlnterfaceO on Its first acquire() and revoked 
via revokelnterfaceO on its last releaseQ from its environment. This second step has to be synchronized with other 
threads in order to get access to mapping tables of an environment by getting an access interface (lockAccessO) from 
the environment. Then an unlockAccessQ function has to be called. 



Function of stub and proxy: 

[0462] The stub is encapsulated in an object which delivers and transforms the binary specification adapted calls to 
the stub. This object is the proxy of a stub in the first binary specification. This proxy which calls and attributes access 
will be similar with the binary specification from which the call was made. The calling to the stub is shown in Fig. 30. 
[0463] First in step 3001 a type save call (e.g. acquire, querylnterface, ...) is made at the proxy 2303. This type save 
call will be transformed by the proxy 2303 to a corresponding call in step 3002 and dispatched to the stub 2304 in step 
3003. After that, the return value of this call is transformed in step 3004 to the type expected by the binary specification. 
[0464] The proxy is binary specification specific. So it is possible to put this object seamless into the binary specifi- 
cation. 

[0465] A stub object is also created which implements an unojnterface and transfomis and delegates the calls to 
the second program implemented in a specific programming language (e.g. C++, Java,...). Fig. 31 describes a call 
through a stub 2304 to the second program 2302. 

[0466] In a first step 3101 the dispatch function is called. If proxy and stub are running in the same process, the 
dispatch function of the stub is directly called by the proxy. In a distributed environment this is not possible. In this case 
the abstract virtual channel has to provide this functionality. On the proxy side the proxy will accept the request and 
transrnit It to the stub side. On the stub side the stub has to call the dispatch function. 

[0467] The stub 2304 detects the interface and the method which should be called at the second program 2302. 
Then in step 31 02 the call was transformed into a specific binary specification by the stub 2304 and the second program 
2302 was called in step 3103. After that, the retum value was re-transfomied to the other binary specification in step 
3104. 

[0468] The stub makes all transformations to the binary specification in which the second program is implemented. 
This is in this example the second binary specification. This makes it possible to implement the second program in the 
second binary specification. For example: In C++ exceptions, multiple inheritance and derivation can be used. In ad- 
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dition to the binary specification there are the type descriptions which must be mapped In the binary specification of 
the second program. 

[0469] In order to enable to call from one binary specification or object model to another the stub and the proxy have 
to undergo a binding process. The proxy allows to call from one binary specification to the uno_interface, while the 
5 stub allows to call through the unojnterface to the second program. The binding of the stub and the proxy is initiated 
by the first software program 2301 and is shown in Fig. 32. In a first step 3201 the generation of a stub with the binary 
UNO specification in the stub factory 3202 is shown. In a second step 3203 a proxy is created based on the generated 
stub in the proxy factory 3204. 

[0470] Each call to the proxy is delivered to the stub. The stub prepares the call and calls the second program in the 
10 corresponding binary specification. Fig. 33 shows exemplary the call from a first software program 2301 in a program- 
ming language like "objective c" to a second software program 2302 which may be implemented in the programming 
language C++. 

[0471] The first software program 2301 uses the programming language "objective c". The proxy 2303 makes the 
interface available to the first software program 2301 in the first binary specification. This means the first software 

IS program 2301 uses the first binary specification to manipulate the second software program 2302. For example, this 
may be effected by the call "char * pOldText = [ myObject changeText; "test"]" in step 3301 . The proxy 2303 transforms 
the parameter of type string to the binary specification in step 3302. Then, the proxy 2303 dispatches in step 3303 the 
call to the stub 2304. The necessary information, including a method type description, parameters, an address for the 
return value and an address for the exception, if any occurs, is delivered to the stub 2304. The stub 2304 transfomns 

20 in step 3304 the string from the binary UNO specification to a second binary specification string. The stub 2304 calls 
the right method at the second software program 2302 in step 3305, in our example "pComponent->changeText("test'') 
". The stub 2304 must catch all kind of exceptions thrown by the second software program 2302. If the method returns 
normally, the string is transformed in the step 3306 to the binary UNO specification and stored at the place given 
through the dispatch call. If an exception is thrown, the exception is transformed and stored at the address given 

25 through the dispatch call. After the dispatch call returns the proxy 2303 transfomis in step 3307 the string to a first 
binary specification string and returns from the "changeText" call. If the call terminates by an exception, the exception 
is returned to the first software program 2301 . It is up to the first binary specification In which manner the exception 
occurs (the "objective c" language does not support exception handling). 

[0472] Fig. 34 shows the advantage of the binary UNO specification as an intermediate binary specification as it was 
30 described above. In a first step 3401 the first software program 2301 , for example written in the programming language 
C++, transmits one command in a first binary specification, in this example the command "setText("a test")", to the 
proxy 2303. Regularly, the first software program will transmit more than one command, for example, also the acquire, 
the release and the querylnterface command as described above. This command will be transfomned by the proxy 
2303 in the next step 3402 from the first binary specification into the binary UNO specification. The command in the 
35 binary UNO specification contains the following information: the parameter "a test", the return address, an address for 
the exceptions, and the type description of the command "setText". The type description of this command will include, 
In this example, the name of the command (setText), the type of the parameter and the return type. This transformed 
command will be transmitted to the stub 2304 in the step 3403. Then, the stub 2304 transforms in step 3404 the 
command from the binary UNO specification Into the second binary specification, employed by the second software 
40 program 2302 which was written, for example, in the programming language Java. The stub 2304 employs for this 
transfonning step only one dispatch mechanism. This is a mechanism which will be employed for each command 
transmitted by the proxy 2303, since it is able to dispatch the name of the command and the other relevant Information 
to the second software program 2302. In the final step 3405 the second software program 2302 executes the command 
"setText". 

45 [0473] The response to this command will be transmitted and transformed in a corresponding way 

[0474] Fig. 35 shows a scenario where between the proxy 2303 and the stub 2304 an interceptor 3501 is inserted. 
This means, that the stub 2304 and the interceptor 3501 are created in a first step, while in a second step the stub 
2303 is created based on information about the stub 2304 and the interceptor 3501 . Therefore, the proxy 2303 will 
communicate only with the interceptor 3501 and not with the stub 2304. 

50 [0475] Such an interceptor may be able to carry out, for example, an accounting function or a security check function. 
If, for example, the first software program 2301 wants to use a functionality of the second software program 2302. the 
interceptor may be able to discover if the user of the first software program is authorized to use this function and to 
debit the account of the user, if the user has to pay for this functionality. Such an interceptor may also be used, for 
example, to help debugging the communication between a first software program 2301 and a second software program 

55 2302. In such a case the interceptor may provide an alarm function which will be initiated, if a predefined functionality 
is called. If the functions requested from the second software program 2302 may be grouped as one transaction, It 
may also be possible that an interceptor cancels all already executed functions of this group, if one function fails. Such 
an interceptor has the advantage that only one interceptor may be employed for every function or method of an interface 
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and for all binary specifications of software programs which communicate via the intermediate binary specification 
used by the stub 2304 and the proxy 2303. 

[0476] Fig. 36 shows a flow chart representing the use of an interceptor as checking and accounting function for a 
fax service. In this example, a user of a first software program using a first binary specification wants to use the fax 
5 service of a second software program using a second binary language, this fax service may distinguish between two 
kinds of users. A standard user may have to pay for each fax and a premium user may have to pay a monthly standard 
fee. 

[0477] In order to enable the communication between the two software programs a stub and a proxy will be created 
and combined and arranged together with a specific interceptor in a way shown In Fig. 35. Then, the following steps 
10 may be carried out. 

[0478] In step 3601 the first software program sends a command including the desired fax number, the con-esponding 
fax file and the identity of the user to the proxy The proxy transforms this command into the intermediate binary spec- 
ification and fonwards it to the interceptor in step 3602. The interceptor checks in step 3603 whether the user is a 
standard user. 

IS [0479] If the answer is "Yes", that means the user is a standard user, the interceptor may deteremine in step 3604 
whether the user has enough credit. If the answer to this question is "No", the user will be informed about his insufficient 
credit status and about the fact that the fax was yet not sent in step 3605. If the answer Is "Yes", that means that the 
user has enough credit, the interceptor will initiate, in this example, the debiting of the user's account in step 3606 and 
fonward the received command to the stub in step 3607. 

20 [0480] If the answer in step 3603 is "No", that means the user is a premium user, the interceptor will forward the 
command received from the proxy directly to the stub In step 3607. The stub will transform this command from the 
intermediate binary specification into the second binary specification and fonward this command to the second software 
program in step 3608. Then the fax may be sent. 

[0481] It will be understood that the present invention is not limited to the examples given and explained in detail. 

25 



Claims 

1 . A method for presenting a runtime environment component service by a first computer system to a second computer 
30 system over a communication network, said method being performed by said first computer system and comprising: 

generating a user interface infrastructure, on said first computer system, to receive graphic user interface 
events from said second computer system and to send remote graphic user interface commands to said second 
computer system; and 

35 

using said user interface infrastructure to initialize said aintime environment component service wherein said 
runtime environment component service sends graphic user interface commands to said user Interface infra- 
structure. 



40 2. The method of Claim 1 further comprising: 

receiving by said user interface infrastructure a remote input action event via said communication network, said 
remote Input action event being generated in said second computer system by a lightweight component corre- 
sponding to said runtime environment component service. 

45 3. The method of Claim 2 further comprising: 

transmitting an input event to said runtime environment component service by said user Interface infrastructure In 
response to said remote input action event 

4. The method of Claim 3 further comprising: 

50 processing said input event by said runtime environment component service. 

5. The method of Claim 4 further comprising: 

generating a graphic user interface command to said user interface infrastructure by said runtime environment 
component service. 

55 

6. The method of Claim 5 further comprising: 

transmitting a remote graphic user interface command to said lightweight component by said graphic user interface 
infrastructure in response to said graphic user interface command. 
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7. A method for presenting a runtime environment component service by a first computer system to a second computer 
system over a communication network, said method being performed by said first computer system and comprising: 

receiving a remote input action command for a runtime environment component sen/ice via said communica- 
5 tion network, said remote Input action command being generated in said second computer system by a light- 

weight component corresponding to said mntime environment component service; 

transmitting a local input action command to said runtime environment component service in response to said 
remote input action command; 

processing said local input action command by said runtime environment component service; 
10 generating a local output command by said runtime environment component sen/ice for a graphical user in- 

terface; and 

transmitting a remote output command to said lightweight component in response to said local output com- 
mand. 

15 8. The method of Claim 7 wherein said runtime environment component service is In an office application suite. 

9. The method of Claim 7 wherein said method further comprises: 

receiving said local output command by a local window object and in response generating said remote output 
command by said local window object 

20 

10. The method of Claim 7 wherein said method further comprises: 

receiving said remote Input action command by a local window object and in response generating said local input 
action command by said local window object. 

25 11. The method of Claim 9 wherein said method further comprises: 

receiving said remote Input action command by said local window object, and In response generating said local 
input action command by said local window object. 

12. The method of claim 10 wherein said remote input action command is a user interface event. 

30 

13. The method of claim 11 wherein said remote Input action command Is a user Interface event. 

14. A method comprising: 

35 receiving a command by a service executing on a computer system to create an infrastmcture for executing 

a runtime environment component service, wherein said command Is from a component executing on a user 
device; and 

issuing an instmction to create an Instance of a remote frame window on said user device. 

40 

15. The method of Claim 14 further comprising: 

generating an instance of a local window on said computer system by said sen/ice. wherein said local window 
Issues remote Instructions to said remote window frame In response to instructions from said runtime environment 
component service. 

45 

1 6. The method of Claim 1 5 further comprising: 

querying said remote frame window by said local window to determine properties of said remote frame window. 

17. The method of Claim 15 further comprising: 

50 generating, on said computer system, a local frame for said local window. " 

18. The method of Claim 1 7 further comprising: 

receiving, by said local frame, a command from said user device to load a document 

55 19. The method of Claim 18 further comprising: . ' 

issuing, in response to said command to load a document, a command by said local frame to said runtime envi- 
ronment component service to create an instance of a runtime environment component service window on said 
computer system. 
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20. The method Claim 1 9 further comprising: 

issuing a command by said local frame to said runtime environment component service to load said document in 
said runtime environment component service window. 

5 21 . The method of Claim 20 further comprising: 

issuing a command from said runtime environment component service to said local window to display said docu- 
ment. 

22. A method for enabling a user device to run a runtime environment component on another computer, said method 
10 comprising: 

running a browser on said user device; and 

running a lightweight component within said browser, wherein said lightweight component receives user input 
actions on said user device and generates corresponding user interface events to said another computer for 
15 processing by said runtime environment component. 

23. The method of Claim 22 further comprising: 
downloading lightweight component into said user device. 

20 24. A computer program product comprising computer code comprising: 
a remote frame window class comprising: 

a remote output device interface; and 
a remote frame window interface. 

25 

25. The computer program product of Claim 24 wherein said computer code further comprises: 
a bean frame class comprising a frame interface. 

26. The computer program product of Claim 24 wherein said computer code further comprises: 
30 a bean window class comprising: 

an event handler interface; and 
an window peer interface. 

35 27. The computer program product of Claim 24 wherein said computer code further comprises: 
an abstract windowing tooll^it. 

28. A computer program product comprising computer code for a method for presenting a runtime environment com- 
ponent service by a first computer system to a second computer system over a communication networi^, said 
40 method being performed by said first computer system, said method comprising: 

generating a user interface infrastructure, on said first computer system, to receive graphic user interface 
events from said second computer system and to send remote graphic user interface commands to said second 
computer system; and 

45 

using said user interface infrastructure to initialize said njntime environment component service wherein said 
mntime environment component service sends graphic user interface commands to said user interface Infra- 
structure. 

50 29. A computer program product comprising computer code for a method for presenting a runtime environment com- 
ponent service by a first computer system to a second computer system over a communication network, said 
method being perfomned by said first computer system and comprising: 

receiving a remote input action command for a runtime environment component service via said communlca- 
55 tion networic, said remote input action command being generated in said second computer system by a light- 

weight component corresponding to said runtime environment component service; 

transmitting a local input action command to said runtime environment component service in response to said 
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remote input action command; 

processing said local input action command by said runtime environment component service; 

5 generating a local output command by said runtime environment component service for a graphical user in- 

terface; and 

transmitting a remote output command to said lightweight component in response to said local output instruc- 
tion. 

10 

30. A method for presenting a runtime environment component service by a first computer system (111) to a second 
computer system (1 1 2A) over a communication network (113), said method being performed by said first computer 
system (111), and comprising the steps of: 

'5 a) receiving a request for a runtime environment component service via said communication network (113), 

said request being generated In said second computer system (112A) by a lightweight component (1210) 
corresponding to said runtime environment component service, 

b) accessing a runtime environment component (1101, 1102, 1103, 1104, 1105, 1106, 1110) being able to 
20 provide said requested runtime environment component service, 

c) executing said runtime environment component (1101, 1102, 1103, 1104, 1105, 1106, 1110) on said first 
computer system (111) for producing a result according to said received request for a mntime environment 

component service, 

25 

d) transmitting, over said network (113), a response comprising said result to said second computer system 
(112A). 

31. A method for providing a runtime environment component sen/Ice from a first computer system (111 ) over a com- 
30 munication network (1 1 3) to a second computer system (11 2A), said method being executed on said second com- 
puter system (11 2A), and comprising the steps of: 

a) generating a request for a runtime environment component service by means of a lightweight component 
(1210) of said second computer system (11 2A), wherein said lightweight component (1210) corresponds to 

3S said runtime environment component sen^ice, 

b) transmitting said request for said runtime environment component service to said first computer system 
(111) over said communication network (113), and 

40 c) receiving a response comprising a result according to said requested runtime environment component serv- 

ice, said result being produced by a runtime environment component (1101, 1102, 1103, 1104, 1105, 1106, 
1110) executed on said first computer system (111) and transmitted with said response by said first computer 
system (111) over said network (113). 

45 32. A method according to any one of the claims 30, 31 , wherein said lightweight component (1 21 0) has a small size 
Is compared to the total size cs In bytes of the at least one runtime environment components (1101 , 1102, 1103, 
1104, 1105, 1106, 1110) providing a service corresponding to said lightweight component (1210) including any 
auxiliary software programs needed to execute said runtime envil-onment components (1101, 1102, 11 03,. 1104, 
1105,1106.1110). 

50 

33. A method according to claim 32, wherein said size Is is equal or less than ten percent of the total size cs. 

34. A method according to any of the claims 30-33, wherein said lightweight component (1 21 0) may be downloaded 
from said first computer system (1 1 1 ) to said second computer system (1 1 2A) over said network (1 1 3) In a time t 

ss equal or less than (8 N / Cg) + t^, wherein N is the total size in bytes of the at least one runtime environment 

component (1101 , 1102, 1103, 1104, 1105, 1106, 1110) providing a sen/ice corresponding to said lightweight com- 
ponent (1210), Cb is the average bandwidth of the network (113), and t^ is the total time needed to initialize said 
runtime environment components (1101, 1102, 1103, 1104. 1105, 1106, 1110) providing a service con-espondlng 
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to said lightweight component (1210) in the local environment on said first computer system (111) in which it is 
embedded. 

35. A method according to any of the claims 30 - 34. wherein said lightweight component (1210) is a non-visual light- 
weight component. 

36. A method according to any of the claims 30 - 35. wherein said lightweight component (1210) may be downloaded 
from said first computer system (111 ) to said second computer system (112A) over said network (113) in a time t 
equal or less than ten seconds. 

37. A method according to any of the claims 30 - 36, wherein said lightweight component (1210) is transmitted from 
said first computer system (111) over said network (1 1 3) to said second computer system (1 1 2A) prior to performing 
a method of any of the preceding claims. 

38. A method according to any of the claims 30 - 37, wherein said mntime environment component services comprise 
at least one of the following functions: graphic functions, word processing functions, document editing functions, 
printing functions. 

39. A method according to any of the claims 30-38, wherein said first computer system (1 1 1 ) is a server system, and 
said second computer system (112A) is a client system. 

40. A method according to any of the claims 30 - 39. wherein said runtime environment components (1101. 1102, 
1103, 1104, 1105, 1106, 1110) comprise at least one application programming interface (API). 

41 . A method according to any of the claims 30 - 40. wherein said runtime environment component sen/ices comprise 
output sen/ices on said second computer system (112A). 

42. A method according to any of the claims 30-41. wherein said request for a runtime environment component 
service is transmitted by said second computer system (112A) into said network (113) by a communication com- 
ponent (1200) of said second computer system (112A). and wherein said response of said first computer system 
(111) to said request is transmitted into said network (113) by a communication component (1100) of said first 
computer system (111). 

43. A method according to the preceding claim, wherein said communication component (1200) is able to generate a 
stub object (1200') and wherein said communication component (1100) is able to generate a proxy object (1100'). 

44. A method according to any of the claims 30- 43, wherein said transmitted request complies with a predetermined 
communication protocol. 

45. A method according to any of the claims 30 - 44, wherein said transmitted request comprises identification data 
of said first computer system (111), identification data of said second computer system (112A). identification data 
of said mntime environment component service, and input data to said runtime environment component service. 

46. A method according to any of the claims 30 - 45. wherein said transmitted result comprises identification data of 
said first computer system (111), Identification data of said second computer system (112A), identification data of 
said runtime environment component service, and output data of said runtime environment component service. 

47. A method according to one of the claims 30 - 46, wherein said communication network (113) complies with the 
Internet protocol http. 

48. A method according to any of the claims 30 - 47, wherein said request and said response are transmitted over a 
secure channel of said communication network (113). 

49. A method according to any of the claims 30 - 48, wherein said first computer system (111) has access to runtime 
' environmentcomponents (1101, 1102, 1103, 1104. 1105, 1106. 1110) which reside on a further computer system. 

50. A method according to any of the claims 30 - 49, wherein said request for said runtime environment component 
sen/ice is generated in said second computer system (112A) by using a Remote Visualization Process (RVP) 
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(1220) and a Abstract Window Toolkit (1260). 

51. A method according to any of the claims 30 - 50, wherein said request for said mntime environment component 
service is received in said first computer system (111 ) by using a Remote Visualization Process (RVP) (1120) and 
a Visual Class Library (VOL) (1140). 

52. „ A method according to any of the claims 30 - 51 . wherein said response of said first computer system (111) is 
transmitted to said second computer system (112A) by using a Remote Visualization Process (RVP) (1120) and 
a Visual Class Library (VCL) (1140). 

53. A method according to any of the claims 30 - 52, wherein said response of said first computer system (111) is 
received in said second computer system (112A) by using a Remote Visualization Process (RVP) (1220) and a 
Abstract Window Toolkit (1 260). 

15 54. A method for presenting njntime environment component services by a first computer system (111) performing the 
method according to claim 30, to a second computer system (1 1 2A) performing the method according to claim 31 . 

55. Data carrier means containing computer software for performing the method according to any of the claims 30 - 54. 

20 56. A computer system for performing the method according to any of the claims 30 - 54. 

57. A set of runtime environment components (1 1 01 , 1 1 02, 1 1 03, 1 1 04, 1 1 05, 1 1 06, 1 1 1 0) for use with a method ac- 
cording to any of the claims 30 - 54. 

25 58. A data base comprising a set of runtime environment components (1101, 1102, 1103, 1104, 1105, 1106, 1110) 
relating to said runtime environment component services according to any of the claims 30 - 54. 
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